Trace Trace Trace Trace Class

Definition

Stellt eine Reihe von Methoden und Eigenschaften für das Verfolgen der Ausführung von Code bereit.Provides a set of methods and properties that help you trace the execution of your code. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class Trace sealed
public sealed class Trace
type Trace = class
Public NotInheritable Class Trace
Vererbung
TraceTraceTraceTrace

Beispiele

Im folgenden Beispiel wird Trace verwendet, um den Anfang und das Ende der Ausführung eines Programms anzugeben.The following example uses Trace to indicate the beginning and the end of a program's execution. Im Beispiel werden auch die Trace.Indent - Trace.Unindent Methode und die-Methode verwendet, um die Ausgabe der Ablauf VerfolgungThe example also uses the Trace.Indent and Trace.Unindent methods to distinguish the tracing output. Ein ausführeres Beispiel für die Verwendung von Tracefinden Sie unter Gewusst wie: Fügen Sie Ablauf Verfolgungs Anweisungen zumAnwendungs Code hinzu.For a more complete example of the use of Trace, see How to: Add Trace Statements to Application Code.

// 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.You can use the properties and methods in the Trace class to instrument release builds. Mithilfe der Instrumentation können Sie die Integrität Ihrer Anwendung überwachen, die in realen Einstellungen ausgeführt wird.Instrumentation allows you to monitor the health of your application running in real-life settings. Die Ablauf Verfolgung hilft Ihnen, Probleme zu isolieren und zu beheben, ohne ein Betriebssystem zu stören.Tracing helps you isolate problems and fix them without disturbing a running system.

Diese Klasse stellt Methoden bereit, um Assert ein Dialogfeld anzuzeigen und eine-Assertion auszugeben, Faildie immer verwendet wird.This class provides methods to display an Assert dialog box, and to emit an assertion that will always Fail. Diese Klasse stellt Schreib Methoden in den folgenden Variationen bereit Write: WriteLine, WriteIf, und WriteLineIf.This class provides write methods in the following variations: Write, WriteLine, WriteIf, and WriteLineIf.

Die BooleanSwitch Klassen TraceSwitch und bieten die Möglichkeit, die Ablauf Verfolgungs Ausgabe dynamisch zu steuern.The BooleanSwitch and TraceSwitch classes provide means to dynamically control the tracing output. Sie können die Werte dieser Switches ändern, ohne die Anwendung neu zu kompilieren.You can modify the values of these switches without recompiling your application. Informationen zum Verwenden der Konfigurationsdatei zum Festlegen eines Schalters finden Sie in Switch der-Klasse und unter Gewusst wie: Thema zum Erstellen, initialisieren und konfigurieren von Ablauf Verfolgungs Schaltern.For information on using the configuration file to set a switch, see the Switch class and the How to: Create, Initialize and Configure Trace Switches topic.

Sie können das Ziel der Ablauf Verfolgungs Ausgabe anpassen, TraceListener indem Sie Instanzen zu einer Auflistung hinzu Listeners fügen oder daraus entfernen.You can customize the tracing output's target by adding TraceListener instances to or removing instances from the Listeners collection. Die Listeners -Auflistung wird von der Debug -Klasse und Trace der-Klasse gemeinsam verwendet. durch das Hinzufügen eines Ablaufverfolgungslistener zu einer der beiden Klassen wirdThe Listeners collection is shared by both the Debug and the Trace classes; adding a trace listener to either class adds the listener to both. Standardmäßig wird die Ausgabe der Ablauf Verfolgung mit DefaultTraceListener der-Klasse ausgegeben.By default, trace output is emitted using the DefaultTraceListener class.

Hinweis

Das Listeners Hinzufügen eines Ablaufverfolgungslistener zur Auflistung kann dazu führen, dass während der Ablauf Verfolgung eine Ausnahme ausgelöst wird, wenn eine vom Ablaufverfolgungslistener verwendete RessourceAdding a trace listener to the Listeners collection can cause an exception to be thrown while tracing, if a resource used by the trace listener is not available. Die Bedingungen und die ausgelöste Ausnahme hängen vom Ablaufverfolgungslistener ab und können in diesem Thema nicht aufgelistet werden.The conditions and the exception thrown depend on the trace listener and cannot be enumerated in this topic. Es kann nützlich sein Trace , Aufrufe der Methoden in try / catch -Blöcken zu platzieren, um Ausnahmen von Ablaufverfolgungslistenern zu erkennen und zu behandeln.It may be useful to place calls to the Trace methods in try/catch blocks to detect and handle any exceptions from trace listeners.

Hinweis

Wenn Sie Ablaufverfolgungslistener teilweise vertrauenswürdigem Code SecurityException hinzufügen, wird eine-Ausnahme UnmanagedCode ausgelöst, da das Hinzufügen von AblaufverfolgungsIf you add trace listeners to partially trusted code, you will get a SecurityException exception, because adding trace listeners requires UnmanagedCode permission. Zum Verfolgen von teilweise vertrauenswürdigem Code, der in einer Sandbox in Visual Studio ausgeführt wird, sollten Sie keine AblaufverfolgungslistenerTo trace partially trusted code that is running in a sandbox in Visual Studio, do not add trace listeners. Sehen Sie sich stattdessen Trace die Debug -und-Meldungen im Ausgabe Fenster an.Instead, view the Trace and Debug messages in the Output window.

Die Trace -Klasse stellt Eigenschaften bereit, um die Ebene von Indent, den IndentSizeund den nach jedem AutoFlush Schreibvorgang zu erhalten oder festzulegen.The Trace class provides properties to get or set the level of Indent, the IndentSize, and whether to AutoFlush after each write.

Zum Festlegen AutoFlush von und IndentSize für Tracekönnen Sie die Konfigurationsdatei bearbeiten, die dem Namen der Anwendung entspricht.To set the AutoFlush and IndentSize for Trace, you can edit the configuration file that corresponds to the name of your application. Die Konfigurationsdatei sollte wie im folgenden Beispiel formatiert sein:The configuration file should be formatted like the following example:

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

Das ConditionalAttribute -Attribut wird auf die Methoden von Traceangewendet.The ConditionalAttribute attribute is applied to the methods of Trace. Compiler, die unter ConditionalAttribute stützen, ignorieren Aufrufe dieser Methoden, es sei denn, "Trace" ist als Symbol für die bedingte Kompilierung definiert.Compilers that support ConditionalAttribute ignore calls to these methods unless "TRACE" is defined as a conditional compilation symbol. In der Dokumentation eines Compilers finden Sie Informationen ConditionalAttribute dazu, ob unterstützt wird, sowie die Syntax zum Definieren eines Symbols für die bedingte Kompilierung.Refer to a compiler's documentation to determine whether ConditionalAttribute is supported and the syntax for defining a conditional compilation symbol.

Hinweis

In Visual Studio-Projekten ist standardmäßig das Symbol für die bedingte Kompilierung "Debuggen" für Debugbuilds definiert, und das Symbol "Trace" wird sowohl für Debug-als auch für Releasebuilds definiert.In Visual Studio projects, by default, the "DEBUG" conditional compilation symbol is defined for debug builds, and the "TRACE" symbol is defined for both debug and release builds. Informationen dazu, wie Sie dieses Verhalten deaktivieren, finden Sie in der Visual Studio-Dokumentation.For information about how to disable this behavior, see the Visual Studio documentation.

Um das bedingte Kompilierungs Symbol "Trace" in C#zu definieren, /d:TRACE fügen Sie die-Option der Compilerbefehlszeile hinzu, wenn Sie den Code mithilfe #define TRACE einer Befehlszeile kompilieren oder am Anfang der Datei hinzufügen.To define the "TRACE" conditional compilation symbol in C#, add the /d:TRACE option to the compiler command line when you compile your code using a command line, or add #define TRACE to the top of your file. Fügen Sie in Visual Basic die /d:TRACE=True -Option der Compilerbefehlszeile #Const TRACE=True hinzu, oder fügen Sie der Datei hinzu.In Visual Basic, add the /d:TRACE=True option to the compiler command line or add #Const TRACE=True to the file.

ConditionalAttributewird vom C++ Compiler nicht unterstützt.ConditionalAttribute is not supported by the C++ compiler. Um die entsprechende Funktionalität bereitzustellen, müssen Sie Aufrufe der-Methoden von Trace in einem #if defined(TRACE) ... #endif - /DTRACE Block einschließen und die-Option der Compilerbefehlszeile #define TRACE hinzufügen oder der Datei hinzufügen.To provide equivalent functionality, you must enclose calls to the methods of Trace in an #if defined(TRACE) ... #endif block, and add the /DTRACE option to the compiler command line or add #define TRACE to the file.

Eigenschaften

AutoFlush AutoFlush AutoFlush AutoFlush

Ruft ab oder legt fest, ob für Flush() nach jeder Ausgabe Listeners aufgerufen werden soll.Gets or sets whether Flush() should be called on the Listeners after every write.

CorrelationManager CorrelationManager CorrelationManager CorrelationManager

Ruft den Korrelations-Manager für den Thread für diese Ablaufverfolgung ab.Gets the correlation manager for the thread for this trace.

IndentLevel IndentLevel IndentLevel IndentLevel

Ruft die Einzugsebene ab oder legt diese fest.Gets or sets the indent level.

IndentSize IndentSize IndentSize IndentSize

Ruft die Anzahl der Leerzeichen in einem Einzug ab oder legt diese fest.Gets or sets the number of spaces in an indent.

Listeners Listeners Listeners Listeners

Ruft die Auflistung der Listener für die Überwachung der Ausgabe der Ablaufverfolgung ab.Gets the collection of listeners that is monitoring the trace output.

UseGlobalLock UseGlobalLock UseGlobalLock UseGlobalLock

Ruft einen Wert ab, der angibt, ob die globale Sperre verwendet werden soll, oder legt diesen fest.Gets or sets a value indicating whether the global lock should be used.

Methoden

Assert(Boolean) Assert(Boolean) Assert(Boolean) Assert(Boolean)

Überprüft eine Bedingung. Wenn die Bedingung false ist, wird ein Meldungsfeld mit der Aufrufliste angezeigt.Checks for a condition; if the condition is false, displays a message box that shows the call stack.

Assert(Boolean, String) Assert(Boolean, String) Assert(Boolean, String) Assert(Boolean, String)

Überprüft eine Bedingung. Wenn die Bedingung false ist, wird eine bestimmte Meldung ausgegeben, und ein Meldungsfeld mit der Aufrufliste wird angezeigt.Checks for a condition; if the condition is false, outputs a specified message and displays a message box that shows the call stack.

Assert(Boolean, String, String) Assert(Boolean, String, String) Assert(Boolean, String, String) Assert(Boolean, String, String)

Überprüft eine Bedingung. Wenn die Bedingung false ist, werden zwei angegebene Meldungen ausgegeben, und ein Meldungsfeld mit der Aufrufliste wird angezeigt.Checks for a condition; if the condition is false, outputs two specified messages and displays a message box that shows the call stack.

Close() Close() Close() Close()

Entleert den Ausgabepuffer und schließt daraufhin die Listeners.Flushes the output buffer, and then closes the Listeners.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Fail(String) Fail(String) Fail(String) Fail(String)

Gibt die angegebene Fehlermeldung aus.Emits the specified error message.

Fail(String, String) Fail(String, String) Fail(String, String) Fail(String, String)

Gibt eine Fehlermeldung sowie eine detaillierte Fehlermeldung aus.Emits an error message, and a detailed error message.

Flush() Flush() Flush() Flush()

Entleert den Ausgabepuffer und veranlasst das Schreiben der gepufferten Daten in die Listeners.Flushes the output buffer, and causes buffered data to be written to the Listeners.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
Indent() Indent() Indent() Indent()

Erhöht den aktuellen IndentLevel um eins.Increases the current IndentLevel by one.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
Refresh() Refresh() Refresh() Refresh()

Aktualisiert die Konfigurationsdaten der Ablaufverfolgung.Refreshes the trace configuration data.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)
TraceError(String) TraceError(String) TraceError(String) TraceError(String)

Schreibt eine Fehlermeldung unter Verwendung der angegebenen Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung.Writes an error message to the trace listeners in the Listeners collection using the specified message.

TraceError(String, Object[]) TraceError(String, Object[]) TraceError(String, Object[]) TraceError(String, Object[])

Schreibt eine Fehlermeldung unter Verwendung des angegebenen Objektarrays und der Formatierungsinformationen in die Ablaufverfolgungslistener in der Listeners-Auflistung.Writes an error message to the trace listeners in the Listeners collection using the specified array of objects and formatting information.

TraceInformation(String) TraceInformation(String) TraceInformation(String) TraceInformation(String)

Schreibt eine Informationsmeldung unter Verwendung der angegebenen Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung.Writes an informational message to the trace listeners in the Listeners collection using the specified message.

TraceInformation(String, Object[]) TraceInformation(String, Object[]) TraceInformation(String, Object[]) TraceInformation(String, Object[])

Schreibt eine Informationsmeldung unter Verwendung des angegebenen Objektarrays und der Formatierungsinformationen in die Ablaufverfolgungslistener in der Listeners-Auflistung.Writes an informational message to the trace listeners in the Listeners collection using the specified array of objects and formatting information.

TraceWarning(String) TraceWarning(String) TraceWarning(String) TraceWarning(String)

Schreibt eine Warnmeldung unter Verwendung der angegebenen Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung.Writes a warning message to the trace listeners in the Listeners collection using the specified message.

TraceWarning(String, Object[]) TraceWarning(String, Object[]) TraceWarning(String, Object[]) TraceWarning(String, Object[])

Schreibt eine Warnmeldung unter Verwendung des angegebenen Objektarrays und der Formatierungsinformationen in die Ablaufverfolgungslistener in der Listeners-Auflistung.Writes a warning message to the trace listeners in the Listeners collection using the specified array of objects and formatting information.

Unindent() Unindent() Unindent() Unindent()

Verringert den aktuellen IndentLevel um eins.Decreases the current IndentLevel by one.

Write(Object) Write(Object) Write(Object) Write(Object)

Schreibt den Wert der ToString()-Methode des Objekts in die Ablaufverfolgungswachungen in der Listeners-Auflistung.Writes the value of the object's ToString() method to the trace listeners in the Listeners collection.

Write(Object, String) Write(Object, String) Write(Object, String) Write(Object, String)

Schreibt einen Kategorienamen und den Wert der ToString()-Methode des Objekts in die Ablaufverfolgungsüberwachungen in der Listeners-Auflistung.Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection.

Write(String) Write(String) Write(String) Write(String)

Schreibt eine Meldung in die Ablaufverfolgungsüberwachungen in der Listeners-Auflistung.Writes a message to the trace listeners in the Listeners collection.

Write(String, String) Write(String, String) Write(String, String) Write(String, String)

Schreibt einen Kategorienamen und eine Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung.Writes a category name and a message to the trace listeners in the Listeners collection.

WriteIf(Boolean, Object) WriteIf(Boolean, Object) WriteIf(Boolean, Object) WriteIf(Boolean, Object)

Schreibt den Wert der ToString()-Methode des Objekts in die Ablaufverfolgungslistener in der Listeners-Auflistung, wenn eine Bedingung true ist.Writes the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteIf(Boolean, Object, String) WriteIf(Boolean, Object, String) WriteIf(Boolean, Object, String) WriteIf(Boolean, Object, String)

Schreibt einen Kategorienamen und den Wert der ToString()-Methode des Objekts in die Ablaufverfolgungslistener in der Listeners-Auflistung, wenn eine Bedingung true ist.Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteIf(Boolean, String) WriteIf(Boolean, String) WriteIf(Boolean, String) WriteIf(Boolean, String)

Schreibt eine Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung, wenn eine Bedingung true ist.Writes a message to the trace listeners in the Listeners collection if a condition is true.

WriteIf(Boolean, String, String) WriteIf(Boolean, String, String) WriteIf(Boolean, String, String) WriteIf(Boolean, String, String)

Schreibt einen Kategorienamen und eine Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung, wenn eine Bedingung true ist.Writes a category name and message to the trace listeners in the Listeners collection if a condition is true.

WriteLine(Object) WriteLine(Object) WriteLine(Object) WriteLine(Object)

Schreibt den Wert der ToString()-Methode des Objekts in die Ablaufverfolgungswachungen in der Listeners-Auflistung.Writes the value of the object's ToString() method to the trace listeners in the Listeners collection.

WriteLine(Object, String) WriteLine(Object, String) WriteLine(Object, String) WriteLine(Object, String)

Schreibt einen Kategorienamen und den Wert der ToString()-Methode des Objekts in die Ablaufverfolgungsüberwachungen in der Listeners-Auflistung.Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection.

WriteLine(String) WriteLine(String) WriteLine(String) WriteLine(String)

Schreibt eine Meldung in die Ablaufverfolgungsüberwachungen in der Listeners-Auflistung.Writes a message to the trace listeners in the Listeners collection.

WriteLine(String, String) WriteLine(String, String) WriteLine(String, String) WriteLine(String, String)

Schreibt einen Kategorienamen und eine Meldung in die Ablaufverfolgungsüberwachungen in der Listeners-Auflistung.Writes a category name and message to the trace listeners in the Listeners collection.

WriteLineIf(Boolean, Object) WriteLineIf(Boolean, Object) WriteLineIf(Boolean, Object) WriteLineIf(Boolean, Object)

Schreibt den Wert der ToString()-Methode des Objekts in die Ablaufverfolgungslistener in der Listeners-Auflistung, wenn eine Bedingung true ist.Writes the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteLineIf(Boolean, Object, String) WriteLineIf(Boolean, Object, String) WriteLineIf(Boolean, Object, String) WriteLineIf(Boolean, Object, String)

Schreibt einen Kategorienamen und den Wert der ToString()-Methode des Objekts in die Ablaufverfolgungslistener in der Listeners-Auflistung, wenn eine Bedingung true ist.Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteLineIf(Boolean, String) WriteLineIf(Boolean, String) WriteLineIf(Boolean, String) WriteLineIf(Boolean, String)

Schreibt eine Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung, wenn eine Bedingung true ist.Writes a message to the trace listeners in the Listeners collection if a condition is true.

WriteLineIf(Boolean, String, String) WriteLineIf(Boolean, String, String) WriteLineIf(Boolean, String, String) WriteLineIf(Boolean, String, String)

Schreibt einen Kategorienamen und eine Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung, wenn eine Bedingung true ist.Writes a category name and message to the trace listeners in the Listeners collection if a condition is true.

Sicherheit

SecurityPermission
für den Betrieb mit nicht verwaltetem Code.for operating with unmanaged code. Sicherheitsaktion: Demand.Security action: Demand. Zugehörige Enumeration:UnmanagedCodeAssociated enumeration: UnmanagedCode

Gilt für:

Threadsicherheit

Dieser Typ ist threadsicher.This type is thread safe.

Siehe auch