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.

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.

Wenn Sie in C# und J# als Symbol für die bedingte Kompilierung "TRACE" definieren möchten, fügen Sie in der Compilerbefehlszeile beim Kompilieren des Codes die /d:TRACE-Option hinzu, oder fügen Sie am Anfang der Datei #define TRACE ein. 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.

In Visual Studio 2005-Projekten ist für Debugbuilds standardmäßig das Symbol für die bedingte Kompilierung "DEBUG" definiert, und für Debug- und Releasebuilds ist das Symbol "TRACE" definiert. Informationen zum Deaktivieren dieses Verhaltens finden Sie in der Dokumentation zu Visual Studio 2005.

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 Verwenden von nicht verwaltetem Code. Sicherheitsaktion: Demand. Zugeordnete Enumeration: SecurityPermissionFlag.UnmanagedCode

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

Dieser Typ ist threadsicher.

Referenz