TraceSwitch Konstruktoren

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.TraceSource.dll

Initialisiert eine neue Instanz der TraceSwitch-Klasse.

Überlädt

TraceSwitch(String, String)	Initialisiert eine neue Instanz der TraceSwitch-Klasse unter Verwendung des angegebenen Anzeigenamens und der angegebenen Beschreibung.
TraceSwitch(String, String, String)	Initialisiert eine neue Instanz der TraceSwitch-Klasse unter Verwendung des angegebenen Anzeigenamens, der angegebenen Beschreibung und des Standardwerts für den Schalter.

TraceSwitch(String, String)

Quelle:

TraceSwitch.cs

Initialisiert eine neue Instanz der TraceSwitch-Klasse unter Verwendung des angegebenen Anzeigenamens und der angegebenen Beschreibung.

public:
 TraceSwitch(System::String ^ displayName, System::String ^ description);

public TraceSwitch (string displayName, string? description);

new System.Diagnostics.TraceSwitch : string * string -> System.Diagnostics.TraceSwitch

Public Sub New (displayName As String, description As String)

Parameter

displayName

String

Der Name, der auf einer Benutzeroberfläche angezeigt werden soll.

description

String

Die Beschreibung des Schalters.

Beispiele

Im folgenden Codebeispiel wird ein neues TraceSwitch erstellt und mithilfe des Schalters bestimmt, ob Fehlermeldungen ausgegeben 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 kleiner Level als TraceLevel.Verboseist.

   // Class-level declaration.
   /* Create a TraceSwitch to use in the entire application.*/
private:
   static TraceSwitch^ mySwitch = gcnew TraceSwitch( "General", "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("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

Bearbeiten Sie für .NET Framework Apps die Konfigurationsdatei, die dem Namen Ihrer Anwendung entspricht, um die Ebene TraceSwitchihrer 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 Schalter löschen. Die Konfigurationsdatei sollte wie im folgenden Beispiel formatiert sein:

<configuration>  
  <system.diagnostics>  
    <switches>  
      <add name="mySwitch" value="1" />  
    </switches>  
  </system.diagnostics>  
</configuration>  

Sie können auch Text verwenden, um den Wert für einen Schalter 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" />.

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 = gcnew TraceSwitch("mySwitch",
        "Switch in config file");

public:
    static void Main(array<String^>^ args)
    {
        //...
        Console::WriteLine("Trace switch {0} configured as {1}",
        appSwitch->DisplayName, appSwitch->Level.ToString());
        if (appSwitch->TraceError)
        {
            //...
        }
    }

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

Dieser Konstruktor legt die Level -Eigenschaft des neuen Schalters auf fest TraceLevel.Off. Oder für .NET Framework-Apps werden die Switcheinstellungen aus der Konfigurationsdatei abgerufen, sofern verfügbar.

Die TraceSwitch -Klasse stellt die TraceErrorEigenschaften , TraceWarning, TraceInfound TraceVerbose bereit, um die des Level Schalters zu testen. Die Level -Eigenschaft ruft den -Schalter ab oder legt diese TraceLevelfest.

Hinweis

Um die Leistung zu verbessern, können Sie Mitglieder static in Ihrer Klasse erstellenTraceSwitch.

Weitere Informationen

• TraceSwitch
• TraceLevel
• Switch
• Debug
• Trace

TraceSwitch(String, String, String)

Quelle:

TraceSwitch.cs

Initialisiert eine neue Instanz der TraceSwitch-Klasse unter Verwendung des angegebenen Anzeigenamens, der angegebenen Beschreibung und des Standardwerts für den Schalter.

public:
 TraceSwitch(System::String ^ displayName, System::String ^ description, System::String ^ defaultSwitchValue);

public TraceSwitch (string displayName, string? description, string defaultSwitchValue);

new System.Diagnostics.TraceSwitch : string * string * string -> System.Diagnostics.TraceSwitch

Public Sub New (displayName As String, description As String, defaultSwitchValue As String)

Parameter

displayName

String

Der Name, der auf einer Benutzeroberfläche angezeigt werden soll.

description

String

Die Beschreibung des Schalters.

defaultSwitchValue

String

Der Standardwert des Schalters.

Hinweise

Der displayName Parameter wird verwendet, um den Wert der DisplayName Eigenschaft festzulegen, der description Parameter wird verwendet, um den Wert der Description Eigenschaft festzulegen, und der defaultSwitchValue Parameter wird als Feld gespeichert und verwendet, um die Value Eigenschaft beim ersten Verweis zu initialisieren. Weitere Informationen und ein Codebeispiel finden Sie im TraceSwitch(String, String) Konstruktor.