TraceSwitch Konstruktorer

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)

Parametrar

Exempel

I följande kodexempel skapas en ny TraceSwitch och växeln används för att avgöra om du vill skriva ut felmeddelanden. Växeln skapas på klassnivå. MyMethod skriver det första felmeddelandet om egenskapen Level är inställd på TraceLevel.Error eller högre. Skriver dock MyMethod inte det andra felmeddelandet om är Level mindre än TraceLevel.Verbose.

//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

Kommentarer

För .NET Framework-appar, för att ange nivån för din TraceSwitch, redigerar du konfigurationsfilen som motsvarar namnet på ditt program. I den här filen kan du lägga till en växel och ange dess värde, ta bort en växel eller rensa alla växlar som tidigare angetts av programmet. Konfigurationsfilen ska formateras som i följande exempel:

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

Du kan också använda text för att ange värdet för en växel. Till exempel true för en BooleanSwitch eller texten som representerar ett uppräkningsvärde, till exempel Error för en TraceSwitch. Raden <add name="mySwitch" value="Error" /> motsvarar <add name="mySwitch" value="1" />.

I ditt program kan du använda den konfigurerade växelnivån genom att skapa en TraceSwitch med samma namn, som du ser i följande exempel:

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

Den här konstruktorn anger egenskapen för Level den nya växeln till TraceLevel.Off. Eller för .NET Framework-appar hämtas växlingsinställningarna från konfigurationsfilen, om det är tillgängligt.

Klassen TraceSwitch innehåller TraceErroregenskaperna , TraceWarning, TraceInfooch TraceVerbose för att testa Level växelns. Egenskapen Level hämtar eller anger växelns TraceLevel.

Se även

• TraceSwitch
• TraceLevel
• Switch
• Debug
• Trace

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)

Parametrar

Kommentarer

Parametern displayName används för att ange värdet DisplayName för egenskapen, parametern description används för att ange värdet Description för egenskapen och parametern defaultSwitchValue sparas som ett fält och används för att initiera Value egenskapen vid den första referensen. Mer information och ett kodexempel finns i TraceSwitch(String, String) konstruktorn.