Share via


Gewusst wie: Erstellen und Initialisieren von Ablaufverfolgungsschaltern

Aktualisiert: November 2007

Damit Sie Ablaufverfolgungsschalter einsetzen können, müssen Sie sie erstellen und im Code platzieren. Für die Erstellung von Schalterobjekten gibt es zwei vordefinierte Klassen: die BooleanSwitch-Klasse und die TraceSwitch-Klasse. Wenn Sie lediglich bestimmen möchten, ob eine Ablaufverfolgungsmeldung angezeigt wird oder nicht, wählen Sie BooleanSwitch. Mit TraceSwitch wird zwischen einzelnen Ablaufverfolgungsebenen unterschieden. Mit einem TraceSwitch können Sie eigene Debugmeldungen definieren und sie verschiedenen Ablaufverfolgungsebenen zuordnen. Beide Schaltertypen lassen sich sowohl bei der Ablaufverfolgung als auch beim Debuggen einsetzen. Standardmäßig ist ein BooleanSwitch deaktiviert, und für einen TraceSwitch ist die Ebene TraceLevel.Off festgelegt. Ablaufverfolgungsschalter können nach Bedarf in jedem beliebigen Teil des Codes platziert werden.

Obgleich Ablaufverfolgungsebenen und weitere Konfigurationsoptionen im Code festgelegt werden können, wird empfohlen, den Status der Schalter in der Konfigurationsdatei zu verwalten. Die Verwaltung der Schalterkonfiguration im Konfigurationssystem verschafft Ihnen größere Flexibilität – Sie können einzelne Schalter aktivieren und deaktivieren und Ebenen ändern, ohne die Anwendung neu kompilieren zu müssen. Weitere Informationen finden Sie unter Konfigurieren von Ablaufverfolgungsschaltern.

So erstellen und initialisieren Sie einen Ablaufverfolgungsschalter

  1. Definieren Sie einen Schalter des Typs BooleanSwitch oder des Typs TraceSwitch, und legen Sie Name und Beschreibung des Schalters fest.

  2. Konfigurieren Sie den Ablaufverfolgungsschalter. Weitere Informationen finden Sie unter Konfigurieren von Ablaufverfolgungsschaltern.

    Im folgenden Codebeispiel werden zwei Schalter erstellt, einer jedes Typs:

    Dim dataSwitch As New BooleanSwitch("Data", "DataAccess module")
    Dim generalSwitch As New TraceSwitch("General", "Entire application")
    
    System.Diagnostics.BooleanSwitch dataSwitch = 
       new System.Diagnostics.BooleanSwitch("Data", "DataAccess module");
    System.Diagnostics.TraceSwitch generalSwitch = 
       new System.Diagnostics.TraceSwitch("General", 
       "Entire application");
    
    System.Diagnostics.BooleanSwitch dataSwitch =
       new System.Diagnostics.BooleanSwitch("Data", "DataAccess module");
    System.Diagnostics.TraceSwitch generalSwitch =
       new System.Diagnostics.TraceSwitch("General", 
       "Entire application");
    

Siehe auch

Aufgaben

Gewusst wie: Konfigurieren von Ablaufverfolgungsschaltern

Konzepte

Ablaufverfolgungsschalter

Einführung in Instrumentation und Ablaufverfolgung