TraceSwitch Klasse

Definition

public ref class TraceSwitch : System::Diagnostics::Switch

public class TraceSwitch : System.Diagnostics.Switch

type TraceSwitch = class
    inherit Switch

Public Class TraceSwitch
Inherits Switch

Vererbung

Object

Switch

TraceSwitch

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("General", "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("General", "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

Sie können einen Ablaufverfolgungswechsel verwenden, um Nachrichten basierend auf ihrer Wichtigkeit herauszufiltern. Die TraceSwitch Klasse stellt die TraceErrorEbenen TraceWarningdes Schalters , , TraceInfound TraceVerbose Eigenschaften zum Testen der Switchebene bereit. Die Level Eigenschaft ruft die Option TraceLevelab oder legt sie fest.

Sie können einen TraceSwitch codespezifischen Code erstellen und die Ebene direkt festlegen, um einen bestimmten Codeabschnitt zu instrumentieren.

In .NET Framework-Apps können Sie auch die Ebene einer TraceSwitch über die Anwendungskonfigurationsdatei festlegen und dann die konfigurierte TraceSwitch Ebene in Ihrer Anwendung verwenden. In der Anwendungskonfigurationsdatei können Sie einen Switch hinzufügen oder entfernen, den Wert eines Switchs festlegen 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="1" />
    </switches>
  </system.diagnostics>
</configuration>

In diesem Konfigurationsabschnitt wird ein TraceSwitch Wert mit dem DisplayName Wert "auf mySwitch" und " Level 1" definiert, der dem Enumerationswert TraceLevel.Errorentspricht.

In Ihrer Anwendung können Sie die konfigurierte Switchebene verwenden, indem Sie einen TraceSwitch mit demselben Namen erstellen, wie im folgenden Beispiel gezeigt:

private static TraceSwitch appSwitch = new TraceSwitch("mySwitch",
    "Switch in config file");

public static void Main(string[] args)
{
    //...
    Console.WriteLine("Trace switch {0} configured as {1}",
    appSwitch.DisplayName, appSwitch.Level.ToString());
    if (appSwitch.TraceError)
    {
        //...
    }
}

Private Shared appSwitch As new TraceSwitch("mySwitch", _
    "Switch in config file")

Public Shared Sub Main(args As String())
    '...
    Console.WriteLine("Trace switch {0} configured as {1}",
    appSwitch.DisplayName, appSwitch.Level.ToString())
    If appSwitch.TraceError = True  Then
        '...
    End If
End Sub

In .NET Core- und .NET 5+-Apps ist der Level neue Switch standardmäßig auf TraceLevel.Off.NET Core und .NET 5+ festgelegt.

In .NET Framework-Apps wird die Switch-Eigenschaft Level standardmäßig auf den in der Konfigurationsdatei angegebenen Wert festgelegt. Wenn der Konstruktor die TraceSwitch anfänglichen Switcheinstellungen in der Konfigurationsdatei nicht finden kann, Level ist der neue Switch standardmäßig auf TraceLevel.Off.

Sie müssen die Ablaufverfolgung oder das Debuggen aktivieren, um einen Switch zu verwenden. Die folgende Syntax ist compilerspezifisch. Wenn Sie andere Compiler als C# oder Visual Basic verwenden, lesen Sie die Dokumentation für den Compiler.

• Um das Debuggen in C# zu aktivieren, fügen Sie die /d:DEBUG Kennzeichnung der Compiler-Befehlszeile hinzu, wenn Sie den Code kompilieren oder am Anfang der Datei hinzufügen #define DEBUG . Fügen Sie in Visual Basic der Compiler-Befehlszeile das /d:DEBUG=True Flag hinzu.

• Um die Ablaufverfolgung in C# zu aktivieren, fügen Sie die /d:TRACE Kennzeichnung der Compiler-Befehlszeile hinzu, wenn Sie den Code kompilieren oder am Anfang der Datei hinzufügen #define TRACE . Fügen Sie in Visual Basic der Compiler-Befehlszeile das /d:TRACE=True Flag hinzu.

Weitere Informationen zur Instrumentierung Ihrer Anwendung finden Sie unter Debug und Trace. Weitere Informationen zum Konfigurieren und Verwenden von Ablaufverfolgungsschaltern finden Sie unter Trace Switches.

Weitere Informationen

• Switch
• BooleanSwitch
• TraceLevel
• Debug
• Trace