Trace Klasse

Definition

public ref class Trace sealed

public sealed class Trace

type Trace = class

Public NotInheritable Class Trace

Vererbung

Object

Trace

Beispiele

Im folgenden Beispiel wird Trace verwendet, um den Anfang und das Ende der Ausführung eines Programms anzugeben. Im Beispiel werden auch die Trace.Indent Methoden und Trace.Unindent verwendet, um die Ablaufverfolgungsausgabe zu unterscheiden. Ein vollständiges Beispiel für die Verwendung von finden Sie unter Vorgehensweise: Hinzufügen vonTrace Ablaufverfolgungsanweisungen zum Anwendungscode.

// Specify /DTRACE when compiling.

#using <System.dll>
using namespace System;
using namespace System::Diagnostics;

int main()
{
   #if defined(TRACE)
   Trace::Listeners->Add( gcnew TextWriterTraceListener( Console::Out ) );
   Trace::AutoFlush = true;
   Trace::Indent();
   Trace::WriteLine( "Entering Main" );
   #endif
   Console::WriteLine( "Hello World." );
   #if defined(TRACE)
   Trace::WriteLine( "Exiting Main" );
   Trace::Unindent();
   #endif
   return 0;
}

// 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();
    }
}

' Specify /d:TRACE=True when compiling.

Imports System.Diagnostics

Class Test
    
    Shared Sub 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()
        
    End Sub

End Class

Hinweise

Sie können die Eigenschaften und Methoden in der Trace -Klasse verwenden, um Releasebuilds zu instrumentieren. Mit der Instrumentierung können Sie die Integrität Ihrer Anwendung überwachen, die in realen Einstellungen ausgeführt wird. Die Ablaufverfolgung hilft Ihnen, Probleme zu isolieren und zu beheben, ohne ein ausgeführtes System zu stören.

Diese Klasse stellt Methoden zum Anzeigen eines Dialogfelds Assert und zum Ausgeben einer Assertion bereit, die immer Failerfolgt. Diese Klasse stellt Schreibmethoden in den folgenden Variationen bereit:

• Write
• WriteLine
• WriteIf
• WriteLineIf

Die BooleanSwitch Klassen und TraceSwitch bieten Mittel zum dynamischen Steuern der Ablaufverfolgungsausgabe. In .NET Framework-Apps können Sie die Werte dieser Switches ändern, ohne Ihre Anwendung neu zu kompilieren. Informationen zur Verwendung der Konfigurationsdatei zum Festlegen eines Schalters in einer .NET Framework-App finden Sie in der Switch Klasse und Vorgehensweise: Create, Initialisieren und Konfigurieren von Ablaufverfolgungsswitches.

Sie können das Ziel der Ablaufverfolgungsausgabe anpassen, indem Sie Der Auflistung Instanzen hinzufügen TraceListener oder aus ihnen Listeners entfernen. Die Listeners Auflistung wird sowohl von der Debug -Klasse als auch von der Trace -Klasse gemeinsam verwendet. Durch das Hinzufügen eines Ablaufverfolgungslisteners zu beiden Klassen wird der Listener beiden hinzugefügt. Standardmäßig wird die Ablaufverfolgungsausgabe mithilfe der DefaultTraceListener -Klasse ausgegeben.

Die Trace -Klasse bietet Eigenschaften zum Abrufen oder Festlegen der Ebene von Indent und des IndentSizeund AutoFlush nach jedem Schreibvorgang.

In .NET Framework-Apps können Sie und AutoFlushIndentSize für Trace festlegen, indem Sie die Konfigurationsdatei bearbeiten, die dem Namen Ihrer 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 auf die Methoden von Traceangewendet. Compiler, die Aufrufe dieser Methoden unterstützen ConditionalAttribute , ignorieren, es sei denn TRACE , sie sind als Symbol für die bedingte Kompilierung definiert. Lesen Sie die Dokumentation eines Compilers, um zu ermitteln, ob ConditionalAttribute unterstützt wird, und die Syntax zum Definieren eines Symbols für die bedingte Kompilierung.

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

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

Eigenschaften

Methoden

Ereignisse

Gilt für:

Threadsicherheit

Dieser Typ ist threadsicher.

Weitere Informationen

• Debug
• Switch
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• EventLogTraceListener
• TraceListenerCollection
• ConditionalAttribute