TraceListener TraceListener TraceListener TraceListener Class

Definition

Stellt die abstract-Basisklasse für die Listener bereit, die die Ablaufverfolgung und die Debugausgabe überwachen.Provides the abstract base class for the listeners who monitor trace and debug output.

public ref class TraceListener abstract : MarshalByRefObject, IDisposable
public abstract class TraceListener : MarshalByRefObject, IDisposable
type TraceListener = class
    inherit MarshalByRefObject
    interface IDisposable
Public MustInherit Class TraceListener
Inherits MarshalByRefObject
Implements IDisposable
Vererbung
Abgeleitet
Implementiert

Hinweise

Beispiele für die Implementierung einer TraceListener, finden Sie unter der DefaultTraceListener, TextWriterTraceListener und EventLogTraceListener Klassen.For examples of how to implement a TraceListener, see the DefaultTraceListener, TextWriterTraceListener and the EventLogTraceListener classes.

Sie müssen die Ablaufverfolgung oder Debuggen verwenden Sie einen Ablaufverfolgungslistener aktivieren.You must enable tracing or debugging to use a trace listener. Die folgende Syntax ist compilerspezifisch.The following syntax is compiler specific. Wenn Sie den Compiler als C#- oder Visual Basic verwenden, finden Sie in der Dokumentation zum Compiler.If you use compilers other than C# or Visual Basic, refer to the documentation for your compiler.

  • Fügen Sie zum Debuggen in c# aktivieren die /d:DEBUG Flag, um die Befehlszeile des Compilers beim Kompilieren des Codes, oder Sie fügen #define DEBUG am Anfang der Datei.To enable debugging in C#, add the /d:DEBUG flag to the compiler command line when you compile your code, or you can add #define DEBUG to the top of your file. Fügen Sie in Visual Basic die /d:DEBUG=True Flag zur Befehlszeile Compilers.In Visual Basic, add the /d:DEBUG=True flag to the compiler command line.

  • Fügen Sie zum Aktivieren der Ablaufverfolgung in c# die /d:TRACE Flag, um die Befehlszeile des Compilers beim Kompilieren des Codes hinzufügen oder #define TRACE am Anfang der Datei.To enable tracing in C#, add the /d:TRACE flag to the compiler command line when you compile your code, or add #define TRACE to the top of your file. Fügen Sie in Visual Basic die /d:TRACE=True Flag zur Befehlszeile Compilers.In Visual Basic, add the /d:TRACE=True flag to the compiler command line.

Um einen Ablaufverfolgungslistener hinzufügen, bearbeiten Sie die Konfigurationsdatei, die den Namen der Anwendung entspricht.To add a trace listener, edit the configuration file that corresponds to the name of your application. In dieser Datei können Sie einen Listener hinzufügen, legen Sie deren Typ und legen Sie die Parameter, einen Listener zu entfernen oder deaktivieren Sie die Listener, die für die zuvor von der Anwendung festgelegt.Within this file, you can add a listener, set its type and set its parameter, remove a listener, or clear all the listeners previously set by the application. Die Konfigurationsdatei sollte ähnlich wie im folgenden Beispiel formatiert werden.The configuration file should be formatted similar to the following example.

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="myListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="TextWriterOutput.log" />  
        <remove name="Default" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>  

Weitere Informationen zur Verwendung von Konfigurationsdateien für die Ablaufverfolgung finden Sie unter <system.diagnostics>.For more information on using configuration files for tracing, see <system.diagnostics>.

Hinweise für Vererber

Erben von dieser Klasse implementiert einen benutzerdefinierten Listener für die Debug und Trace Klassen.Inherit from this class to implement a custom listener for the Debug and Trace classes. Sie müssen mindestens implementieren die Write(String) und WriteLine(String) Methoden.At a minimum, you must implement the Write(String) and WriteLine(String) methods. Sie können darüber hinaus implementieren die Fail(String), Close() und Flush() Methoden.Additionally, you can implement the Fail(String), Close() and Flush() methods.

Konstruktoren

TraceListener() TraceListener() TraceListener() TraceListener()

Initialisiert eine neue Instanz der TraceListener-Klasse.Initializes a new instance of the TraceListener class.

TraceListener(String) TraceListener(String) TraceListener(String) TraceListener(String)

Initialisiert eine neue Instanz der TraceListener-Klasse unter Verwendung des angegebenen Namens als Listener.Initializes a new instance of the TraceListener class using the specified name as the listener.

Eigenschaften

Attributes Attributes Attributes Attributes

Ruft die benutzerdefinierten Attribute für Ablaufverfolgungslistener ab, die in der Anwendungskonfigurationsdatei definiert sind.Gets the custom trace listener attributes defined in the application configuration file.

Filter Filter Filter Filter

Ruft den Ablaufverfolgungsfilter für den Ablaufverfolgungslistener ab oder legt diesen fest.Gets or sets the trace filter for the trace listener.

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.

IsThreadSafe IsThreadSafe IsThreadSafe IsThreadSafe

Ruft einen Wert ab, der angibt, ob der Ablaufverfolgungslistener threadsicher ist.Gets a value indicating whether the trace listener is thread safe.

Name Name Name Name

Ruft einen Namen für diesen TraceListener ab oder legt diesen fest.Gets or sets a name for this TraceListener.

NeedIndent NeedIndent NeedIndent NeedIndent

Ruft einen Wert ab, der einen Einzug für die Ausgabe angibt, oder legt diesen fest.Gets or sets a value indicating whether to indent the output.

TraceOutputOptions TraceOutputOptions TraceOutputOptions TraceOutputOptions

Ruft die Optionen für die Ablaufverfolgungsausgabe ab oder legt diese fest.Gets or sets the trace output options.

Methoden

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

Schließt beim Überschreiben in einer abgeleiteten Klasse den Ausgabestream, sodass dieser keine Ablaufverfolgungs- oder Debugausgaben mehr empfängt.When overridden in a derived class, closes the output stream so it no longer receives tracing or debugging output.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Gibt alle vom TraceListener verwendeten Ressourcen frei.Releases all resources used by the TraceListener.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Gibt die von TraceListener verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the TraceListener and optionally releases the managed resources.

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 eine Fehlermeldung an den Listener aus, den Sie beim Implementieren der TraceListener-Klasse erstellen.Emits an error message to the listener you create when you implement the TraceListener class.

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

Gibt eine Fehlermeldung sowie eine detaillierte Fehlermeldung an den Listener aus, den Sie beim Implementieren der TraceListener-Klasse erstellen.Emits an error message and a detailed error message to the listener you create when you implement the TraceListener class.

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

Entleert beim Überschreiben in einer abgeleiteten Klasse den Ausgabepuffer.When overridden in a derived class, flushes the output buffer.

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

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetSupportedAttributes() GetSupportedAttributes() GetSupportedAttributes() GetSupportedAttributes()

Ruft die vom Ablaufverfolgungslistener unterstützten benutzerdefinierten Attribute ab.Gets the custom attributes supported by the trace listener.

GetType() GetType() GetType() GetType()

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

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
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)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object) TraceData(TraceEventCache, String, TraceEventType, Int32, Object) TraceData(TraceEventCache, String, TraceEventType, Int32, Object) TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Schreibt Ablaufverfolgungsinformationen, ein Datenobjekt und Ereignisinformationen in die spezifische Ausgabe des Listeners.Writes trace information, a data object and event information to the listener specific output.

TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Schreibt Ablaufverfolgungsinformationen, ein Array von Datenobjekten und Ereignisinformationen in die spezifische Ausgabe des Listeners.Writes trace information, an array of data objects and event information to the listener specific output.

TraceEvent(TraceEventCache, String, TraceEventType, Int32) TraceEvent(TraceEventCache, String, TraceEventType, Int32) TraceEvent(TraceEventCache, String, TraceEventType, Int32) TraceEvent(TraceEventCache, String, TraceEventType, Int32)

Schreibt Ablaufverfolgungs- und Ereignisinformationen in die spezifische Ausgabe des Listeners.Writes trace and event information to the listener specific output.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Schreibt Ablaufverfolgungsinformationen, eine Meldung und Ereignisinformationen in die spezifische Ausgabe des Listeners.Writes trace information, a message, and event information to the listener specific output.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Schreibt Ablaufverfolgungsinformationen, ein formatiertes Array von Objekten und Ereignisinformationen in die spezifische Ausgabe des Listeners.Writes trace information, a formatted array of objects and event information to the listener specific output.

TraceTransfer(TraceEventCache, String, Int32, String, Guid) TraceTransfer(TraceEventCache, String, Int32, String, Guid) TraceTransfer(TraceEventCache, String, Int32, String, Guid) TraceTransfer(TraceEventCache, String, Int32, String, Guid)

Schreibt Ablaufverfolgungsinformationen, eine Meldung, eine verwandte Aktivitätsidentität und Ereignisinformationen an die spezifische Ausgabe des Listeners.Writes trace information, a message, a related activity identity and event information to the listener specific output.

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

Schreibt den Wert der ToString()-Methode des Objekts in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

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

Schreibt einen Kategorienamen und den Wert der ToString()-Methode eines Objekts in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen.Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

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

Schreibt beim Überschreiben in einer abgeleiteten Klasse die angegebene Meldung in den Listener, den Sie in der abgeleiteten Klasse erstellen.When overridden in a derived class, writes the specified message to the listener you create in the derived class.

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

Schreibt einen Kategorienamen und eine Meldung in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen.Writes a category name and a message to the listener you create when you implement the TraceListener class.

WriteIndent() WriteIndent() WriteIndent() WriteIndent()

Schreibt den Einzug in den Listener, den sie bei der Implementierung dieser Klasse erstellen, und setzt die NeedIndent-Eigenschaft auf false zurück.Writes the indent to the listener you create when you implement this class, and resets the NeedIndent property to false.

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

Schreibt den Wert der ToString()-Methode des Objekts gefolgt von einem Zeilenabschluss in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator.

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

Schreibt einen Kategorienamen und den Wert der ToString()-Methode eines Objekts gefolgt von einem Zeilenabschluss in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen.Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator.

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

Schreibt beim Überschreiben in einer abgeleiteten Klasse eine Meldung, gefolgt von einem Zeilenabschluss in den Listener, den Sie in der abgeleiteten Klasse erstellen.When overridden in a derived class, writes a message to the listener you create in the derived class, followed by a line terminator.

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

Schreibt einen Kategorienamen und eine Meldung gefolgt von einem Zeilenabschluss in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen.Writes a category name and a message to the listener you create when you implement the TraceListener class, followed by a line terminator.

Gilt für:

Threadsicherheit

Dieser Typ ist threadsicher.This type is thread safe.

Siehe auch