TraceSwitch Constructors

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)

Parameters

Voorbeelden

In het volgende codevoorbeeld wordt een nieuwe TraceSwitch gemaakt en wordt de schakeloptie gebruikt om te bepalen of foutberichten moeten worden afgedrukt. De switch wordt gemaakt op klasseniveau. MyMethod schrijft het eerste foutbericht als de Level eigenschap is ingesteld op TraceLevel.Error of hoger. MyMethod Schrijft echter niet het tweede foutbericht als de Level waarde kleiner is dan 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

Opmerkingen

Als u voor .NET Framework-apps het niveau van uw TraceSwitch wilt instellen, bewerkt u het configuratiebestand dat overeenkomt met de naam van uw toepassing. In dit bestand kunt u een switch toevoegen en de bijbehorende waarde instellen, een schakeloptie verwijderen of alle schakelopties wissen die eerder door de toepassing zijn ingesteld. Het configuratiebestand moet worden opgemaakt zoals in het volgende voorbeeld:

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

U kunt ook tekst gebruiken om de waarde voor een schakeloptie op te geven. Bijvoorbeeld true voor een BooleanSwitch of de tekst die een opsommingswaarde vertegenwoordigt, zoals Error voor een TraceSwitch. De regel <add name="mySwitch" value="Error" /> is gelijk aan <add name="mySwitch" value="1" />.

In uw toepassing kunt u het geconfigureerde switchniveau gebruiken door een TraceSwitch met dezelfde naam te maken, zoals wordt weergegeven in het volgende voorbeeld:

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

Met deze constructor wordt de Level eigenschap van de nieuwe switch ingesteld op TraceLevel.Off. Of voor .NET Framework-apps worden de switchinstellingen verkregen uit het configuratiebestand, indien beschikbaar.

De TraceSwitch klasse biedt de TraceErroreigenschappen , TraceWarningen TraceInfoTraceVerbose eigenschappen om de Level switch te testen. De Level eigenschap haalt of stelt de schakeloptie TraceLevelin.

Zie ook

• 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)

Parameters

Opmerkingen

De displayName parameter wordt gebruikt om de waarde van de DisplayName eigenschap in te stellen, de description parameter wordt gebruikt om de waarde van de Description eigenschap in te stellen en de defaultSwitchValue parameter wordt opgeslagen als een veld en wordt gebruikt om de Value eigenschap bij de eerste verwijzing te initialiseren. Zie de TraceSwitch(String, String) constructor voor meer informatie en een codevoorbeeld.