Trace-Klasse

Sie können die Eigenschaften und die Methoden der Trace-Klasse verwenden, um Releasebuilds zu instrumentieren. Über die Instrumentation können Sie die fehlerfreie Funktion der Anwendung bei realen Ausführungsbedingungen überwachen. Die Ablaufverfolgung ermöglicht das Eingrenzen und Beheben von Problemen, ohne die Ausführung eines Systems zu stören.

Diese Klasse stellt Methoden für die Anzeige eines Dialogfelds Assert und die Ausgabe einer Assertion bereit, die immer zu einem Fail führt. Diese Klasse schreibt Methoden in folgenden Variationen: Write, WriteLine, WriteIf und WriteLineIf.

Mit der BooleanSwitch-Klasse und der TraceSwitch-Klasse kann die Ausgabe der Ablaufverfolgung dynamisch gesteuert werden. Sie können die Werte dieser Schalter ändern, ohne die Anwendung erneut zu kompilieren. Informationen über das Festlegen eines Schalters mithilfe der Konfigurationsdatei finden Sie unter der Switch-Klasse und im Thema Gewusst wie: Konfigurieren von Ablaufverfolgungsschaltern.

Sie können das Ziel der Ablaufverfolgungsausgabe anpassen, indem Sie in der Listeners-Auflistung TraceListener-Instanzen hinzufügen oder diese aus dieser entfernen. Die Listeners-Auflistung wird von den Klassen Debug und Trace gemeinsam genutzt; beim Hinzufügen eines Listeners zu einer der Klassen wird der Listener beiden hinzugefügt. In der Standardeinstellung erfolgt die Ausgabe der Ablaufverfolgung über die DefaultTraceListener-Klasse.

Hinweis

Einen Ablaufverfolgungslistener zur Listeners-Auflistung hinzuzufügen kann bei der Ablaufverfolgung eine Ausnahme verursachen, wenn eine vom Ablaufverfolgungslistener verwendete Ressource nicht verfügbar ist. Die Bedingungen und die Ausnahme, die ausgelöst wurde, hängen vom Ablaufverfolgungslistener ab, und können nicht in diesem Thema aufgelistet werden. Möglicherweise empfiehlt es sich, Aufrufe der Trace-Methoden in try/catch-Blocks auszuführen, um eventuelle Ausnahmen von Ablaufverfolgungslistenern zu erkennen und zu verarbeiten.

Hinweis

Wenn Sie Ablaufverfolgungslistener für teilweise vertrauenswürdigen Code hinzufügen, erhalten Sie eine SecurityException-Ausnahme ab, da das Hinzufügen von Ablaufverfolgungslistenern UnmanagedCode-Berechtigung erfordert. Zum Erfassen von teilweise vertrauenswürdigem Code in einem Sandkasten in Visual Studio ausgeführt wird, fügen Sie keine Ablaufverfolgungslistener hinzu. Stattdessen zeigen Sie die Trace und Debug-Nachrichten im Ausgabe-Fenster angezeigt.

Die Trace-Klasse stellt Eigenschaften bereit, mit denen die Ebene von Indent sowie IndentSize abgerufen oder festgelegt und eine Ausführung von AutoFlush nach jeder Ausgabe festgelegt werden kann.

Zum Festlegen von AutoFlush und IndentSize für Trace bearbeiten Sie die Konfigurationsdatei, die dem Namen der Anwendung entspricht. Die Konfigurationsdatei sollte wie im folgenden Beispiel formatiert werden:

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="3" />
  </system.diagnostics>
</configuration>

Das ConditionalAttribute-Attribut wird für die Methoden von Trace übernommen. Compiler, die ConditionalAttribute unterstützen, ignorieren Aufrufe dieser Methoden, sofern als Symbol für die bedingte Kompilierung nicht "TRACE" definiert ist. In der Dokumentation des Compilers finden Sie Informationen dazu, wie Sie ermitteln, ob ConditionalAttribute unterstützt, sowie die Syntax zum Definieren eines Symbols für die bedingte Kompilierung.

Hinweis
In Visual Studio-Projekten standardmäßig dem Namen "DEBUGES" Symbol für die bedingte Kompilierung wird für Debugbuilds definiert, und "Symbol" ABLAUFVERFOLGUNGS für beide debuggen und Releasebuilds definiert. Informationen zum Deaktivieren dieses Verhaltens finden Sie in der Visual Studio-Dokumentation.

Um das "ABLAUFVERFOLGUNGS" Symbol für die bedingte Kompilierung in C# zu definieren, fügen Sie die Option /d:TRACE der Compilerbefehlszeile wenn Sie den Code mithilfe einer Befehlszeile kompilieren #define TRACE hinzu, oder fügen Sie am Anfang der Datei hinzu. In Visual Basic fügen Sie der Compilerbefehlszeile die /d:TRACE=True-Option hinzu, oder fügen Sie der Datei #Const TRACE=True hinzu.

ConditionalAttribute wird vom C++-Compiler nicht unterstützt. Um die entsprechende Funktionalität bereitzustellen, müssen Sie Aufrufe der Methoden von Trace in einem #if defined(TRACE) ... #endif-Block einschließen und der Compilerbefehlszeile die /DTRACE-Option hinzufügen oder der Datei #define TRACE hinzufügen.

Im folgenden Beispiel werden mit Trace Anfang und Ende für die Programmausführung angezeigt. Außerdem wird in dem Beispiel die Ausgabe der Ablaufverfolgung mit der Trace.Indent-Methode und der Trace.Unindent-Methode hervorgehoben. Ein vollständigeres Beispiel für die Verwendung von Trace finden Sie unter Gewusst wie: Hinzufügen von Ablaufverfolgungsanweisungen zu Anwendungscode.

// Specify /d:TRACE when compiling.

using System;
using System.Diagnostics;

class Test
{
    static void Main()
    {
       Trace.Listeners.Add(new TextWriterTraceListener(Console.Out));
       Trace.AutoFlush = true;
       Trace.Indent();
       Trace.WriteLine("Entering Main");
       Console.WriteLine("Hello World.");
       Trace.WriteLine("Exiting Main"); 
       Trace.Unindent();
    }
}

.NET Framework

.NET Framework Client Profile

• SecurityPermission 

  für das Arbeiten mit nicht verwaltetem Code. Sicherheitsaktion: Demand. Zugeordnete Enumeration: SecurityPermissionFlag.UnmanagedCode.

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Dieser Typ ist threadsicher.

Referenz