TraceSwitch.Level-Eigenschaft

Ruft die Ablaufverfolgungsebene ab, die die Meldungen bestimmt, die der Schalter zulässt, oder legt diese fest.

Namespace: System.Diagnostics
Assembly: System (in system.dll)

Syntax

'Declaration
Public Property Level As TraceLevel
'Usage
Dim instance As TraceSwitch
Dim value As TraceLevel

value = instance.Level

instance.Level = value

public TraceLevel Level { get; set; }

public:
property TraceLevel Level {
    TraceLevel get ();
    void set (TraceLevel value);
}

/** @property */
public TraceLevel get_Level ()

/** @property */
public void set_Level (TraceLevel value)

public function get Level () : TraceLevel

public function set Level (value : TraceLevel)

Eigenschaftenwert

Einer der TraceLevel-Werte, der die Ebene der vom Schalter zugelassenen Meldungen angibt.

Ausnahmen

Hinweise

Bearbeiten Sie zum Festlegen der Ebene des TraceSwitch die Konfigurationsdatei, die dem Namen der Anwendung entspricht. In dieser Datei können Sie einen Schalter hinzufügen und dessen Wert festlegen, einen Schalter entfernen oder alle Schalter löschen, die zuvor durch die Anwendung festgelegt wurden. Die Konfigurationsdatei sollte wie im folgenden Beispiel formatiert werden:

<configuration>
  <system.diagnostics>
    <switches>
      <add name="mySwitch" value="0" />
      <add name="myNewSwitch" value="3" />
      <remove name="mySwitch" />
      <clear/>
    </switches>
  </system.diagnostics>
</configuration>

Wenn der TraceSwitch-Konstruktor keine Anfangseinstellungen für den Schalter in der Konfigurationsdatei findet, wird die Level-Eigenschaft des neuen Schalters auf TraceLevel.Off festgelegt.

Durch das Festlegen dieser Eigenschaft wird die TraceError-Eigenschaft, TraceWarning-Eigenschaft, TraceInfo-Eigenschaft und TraceVerbose-Eigenschaft aktualisiert, um den neuen Wert wiederzugeben.

Beispiel

Im folgenden Codebeispiel wird ein neuer TraceSwitch erstellt und mit diesem Schalter bestimmt, ob Fehlermeldungen ausgegeben werden sollen. Der Schalter wird auf Klassenebene erstellt. MyMethod gibt die erste Fehlermeldung aus, wenn die Level-Eigenschaft auf TraceLevel.Error oder höher festgelegt ist. MyMethod gibt die zweite Fehlermeldung jedoch nicht aus, wenn Level kleiner als TraceLevel.Verbose ist.

' 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

//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:
   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.
 */
private static TraceSwitch mySwitch = 
    new TraceSwitch("General", "Entire Application");

public static void MyMethod()
{
    //Write the message if the TraceSwitch level is set to Error or higher.
    if (mySwitch.get_TraceError()) {
        Console.WriteLine("My error message.");
    }

    // Write the message if the TraceSwitch level is set to Verbose.
    if (mySwitch.get_TraceVerbose()) {
        Console.WriteLine("My second error message.");
    }
} //MyMethod

public static void main(String[] args)
{
    // Run the method that prints error messages based on the switch level.
    MyMethod();
} //main

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

TraceSwitch-Klasse
TraceSwitch-Member
System.Diagnostics-Namespace
TraceSwitch-Klasse
TraceLevel-Enumeration
Switch-Klasse
Debug-Klasse
Trace-Klasse