TraceSwitch.Level Eigenschaft

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.TraceSource.dll

Quelle:

TraceSwitch.cs

Ruft die Ablaufverfolgungsebene ab, die die Meldungen bestimmt, die der Schalter zulässt, oder legt diese fest.

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, set

Public Property Level As TraceLevel

Eigenschaftswert

TraceLevel

Einer der TraceLevel Werte, der die Ebene der Nachrichten angibt, die vom Switch zulässig sind.

Ausnahmen

ArgumentException

Level wird auf einen Wert festgelegt, der mit keinem der TraceLevel-Werte übereinstimmt.

Beispiele

Im folgenden Codebeispiel wird eine neue TraceSwitch erstellt und mithilfe des Schalters ermittelt, ob Fehlermeldungen ausgegeben werden sollen. Der Switch 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 kleiner Level als TraceLevel.Verboseist.

   // Class-level declaration.
   /* Create a TraceSwitch to use in the entire application.*/
private:
   static TraceSwitch^ mySwitch = gcnew TraceSwitch( "mySwitch","Entire Application" );

public:
   static 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." );
   }

   static void main()
   {
      // 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.*/

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 TraceSwitchIhres festzulegen. In dieser Datei können Sie einen Switch hinzufügen und dessen Wert festlegen, einen Schalter entfernen oder alle zuvor von der Anwendung festgelegten Switches 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 Switch anzugeben. Beispielsweise für einen BooleanSwitch oder den Text, true der einen Enumerationswert darstellt, zError. B. für einen TraceSwitch. Die Zeile <add name="mySwitch" value="Error" /> ist gleichbedeutend mit <add name="mySwitch" value="1" />.

Der Standardwert der Level -Eigenschaft ist TraceLevel.Off. Für .NET Framework-Apps wird die Ebene auch aus der Konfigurationsdatei abgerufen, sofern verfügbar.

Durch Festlegen dieser Eigenschaft werden die TraceErrorEigenschaften , TraceWarning, TraceInfound TraceVerbose aktualisiert, um den neuen Wert widerzuspiegeln.

Weitere Informationen

• TraceSwitch
• TraceLevel
• Switch
• Debug
• Trace