TraceSwitch.Level Eigenschap

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

Waarde van eigenschap

Een van de TraceLevel waarden die het niveau van berichten aangeeft dat is toegestaan door de schakeloptie.

Uitzonderingen

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

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="0" />
      <add name="myNewSwitch" value="3" />
      <remove name="mySwitch" />
      <clear/>
    </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" />.

De standaardwaarde van de Level eigenschap is TraceLevel.Off. Of voor .NET Framework-apps wordt het niveau verkregen uit het configuratiebestand, indien beschikbaar.

Als u deze eigenschap instelt, TraceVerbose worden de TraceError, TraceWarningen TraceInfoeigenschappen bijgewerkt zodat deze overeenkomen met de nieuwe waarde.

Zie ook

• TraceSwitch
• TraceLevel
• Switch
• Debug
• Trace