TraceSwitch.Level Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen der Ablaufverfolgungsebene, die die Nachrichten bestimmt, die der Switch zulässt.
public:
property System::Diagnostics::TraceLevel Level { System::Diagnostics::TraceLevel get(); void set(System::Diagnostics::TraceLevel value); };public System.Diagnostics.TraceLevel Level { get; set; }member this.Level : System.Diagnostics.TraceLevel with get, setPublic Property Level As TraceLevelEigenschaftswert
Einer der TraceLevel Werte, der die Ebene der Nachrichten angibt, die von der Option zulässig sind.
Ausnahmen
Level wird auf einen Wert festgelegt, der nicht einer der TraceLevel Werte ist.
Beispiele
Im folgenden Codebeispiel wird ein neues TraceSwitch Beispiel erstellt und der Schalter verwendet, um zu bestimmen, ob Fehlermeldungen gedruckt werden sollen. Der Schalter wird auf Klassenebene erstellt.
MyMethod schreibt die erste Fehlermeldung, wenn die Level Eigenschaft auf TraceLevel.Error oder höher festgelegt ist. Schreibt jedoch nicht die zweite Fehlermeldung, MyMethod wenn dies Level kleiner als TraceLevel.Verboseist.
//Class-level declaration.
/* Create a TraceSwitch to use in the entire application.*/
static TraceSwitch mySwitch = new TraceSwitch("mySwitch", "Entire Application");
static public void MyMethod()
{
// Write the message if the TraceSwitch level is set to Error or higher.
if (mySwitch.TraceError)
Console.WriteLine("My error message.");
// Write the message if the TraceSwitch level is set to Verbose.
if (mySwitch.TraceVerbose)
Console.WriteLine("My second error message.");
}
public static void Main(string[] args)
{
// Run the method that prints error messages based on the switch level.
MyMethod();
}
' Class-level declaration.
' Create a TraceSwitch to use in the entire application.
Private Shared mySwitch As New TraceSwitch("mySwitch", "Entire Application")
Public Shared Sub MyMethod()
' Write the message if the TraceSwitch level is set to Error or higher.
If mySwitch.TraceError Then
Console.WriteLine("My error message.")
End If
' Write the message if the TraceSwitch level is set to Verbose.
If mySwitch.TraceVerbose Then
Console.WriteLine("My second error message.")
End If
End Sub
Public Shared Sub Main()
' Run the method that prints error messages based on the switch level.
MyMethod()
End Sub
Hinweise
Bearbeiten Sie für .NET Framework-Apps die Konfigurationsdatei, die dem Namen Ihrer Anwendung entspricht, um die Ebene Dess TraceSwitchfestzulegen. In dieser Datei können Sie einen Schalter hinzufügen und dessen Wert festlegen, einen Schalter entfernen oder alle zuvor von der Anwendung festgelegten Schalter löschen. Die Konfigurationsdatei sollte wie im folgenden Beispiel formatiert werden:
<configuration>
<system.diagnostics>
<switches>
<add name="mySwitch" value="0" />
<add name="myNewSwitch" value="3" />
<remove name="mySwitch" />
<clear/>
</switches>
</system.diagnostics>
</configuration>
Sie können auch Text verwenden, um den Wert für einen Schalter anzugeben. For example, true for a BooleanSwitch or the text representing an enumeration value, such Error as for a TraceSwitch. Die Zeile <add name="mySwitch" value="Error" /> entspricht <add name="mySwitch" value="1" />.
Der Standardwert dieser Eigenschaft Level lautet TraceLevel.Off. Oder für .NET Framework-Apps wird die Ebene aus der Konfigurationsdatei abgerufen, sofern verfügbar.
Durch Festlegen dieser Eigenschaft werden die TraceErrorneuen TraceInfoTraceWarningTraceVerbose Werte und Eigenschaften aktualisiert.
