TraceListener Klasse

Definition

Namespace:
System.Diagnostics
Assemblys:
netstandard.dll, System.Diagnostics.TraceSource.dll
Assembly:
System.Diagnostics.TraceSource.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Quelle:
TraceListener.cs
Quelle:
TraceListener.cs
Quelle:
TraceListener.cs
Quelle:
TraceListener.cs
Quelle:
TraceListener.cs

Stellt die abstract Basisklasse für die Listener bereit, die die Ablaufverfolgung überwachen und die Ausgabe debuggen.

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

Hinweise

Beispiele für die Implementierung eines TraceListener, siehe die DefaultTraceListenerKlassen TextWriterTraceListener und die EventLogTraceListener Klassen.

Sie müssen die Ablaufverfolgung oder das Debuggen aktivieren, um einen Ablaufverfolgungslistener zu verwenden. Die folgende Syntax ist compilerspezifisch. Wenn Sie andere Compiler als C# oder Visual Basic verwenden, lesen Sie die Dokumentation für den Compiler.

  • Um das Debuggen in C# zu aktivieren, fügen Sie die /d:DEBUG Kennzeichnung der Compiler-Befehlszeile hinzu, wenn Sie den Code kompilieren, oder Sie können am Anfang der Datei hinzufügen #define DEBUG . Fügen Sie in Visual Basic der Compiler-Befehlszeile das /d:DEBUG=True Flag hinzu.

  • Um die Ablaufverfolgung in C# zu aktivieren, fügen Sie die /d:TRACE Kennzeichnung der Compiler-Befehlszeile hinzu, wenn Sie den Code kompilieren oder am Anfang der Datei hinzufügen #define TRACE . Fügen Sie in Visual Basic der Compiler-Befehlszeile das /d:TRACE=True Flag hinzu.

Um einen Ablaufverfolgungslistener hinzuzufügen, bearbeiten Sie die Konfigurationsdatei, die dem Namen Ihrer Anwendung entspricht. In dieser Datei können Sie einen Listener hinzufügen, dessen Typ festlegen und seinen Parameter festlegen, einen Listener entfernen oder alle Listener löschen, die zuvor von der Anwendung festgelegt wurden. Die Konfigurationsdatei sollte ähnlich wie im folgenden Beispiel formatiert werden.

<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>".

Hinweise für Ausführende

Erben Sie von dieser Klasse, um einen benutzerdefinierten Listener für die Debug und Trace klassen zu implementieren. Sie müssen mindestens die Write(String) Methoden WriteLine(String) implementieren. Darüber hinaus können Sie die Fail(String)Methoden Close() und Flush() Methoden implementieren.

Konstruktoren

Name Beschreibung
TraceListener()

Initialisiert eine neue Instanz der TraceListener-Klasse.
TraceListener(String)

Initialisiert eine neue Instanz der TraceListener Klasse unter Verwendung des angegebenen Namens als Listener.

Eigenschaften

Name Beschreibung
Attributes

Ruft die benutzerdefinierten Listenerattribute der Ablaufverfolgung ab, die in der Anwendungskonfigurationsdatei definiert sind.
Filter

Dient zum Abrufen oder Festlegen des Ablaufverfolgungsfilters für den Ablaufverfolgungslistener.
IndentLevel

Dient zum Abrufen oder Festlegen der Einzugsebene.
IndentSize

Dient zum Abrufen oder Festlegen der Anzahl von Leerzeichen in einem Einzug.
IsThreadSafe

Ruft einen Wert ab, der angibt, ob der Ablaufverfolgungslistener threadsicher ist.
Name

Dient zum Abrufen oder Festlegen eines Namens für dieses TraceListener.
NeedIndent

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Ausgabe eingezogen werden soll.
TraceOutputOptions

Ruft die Ausgabeoptionen für die Ablaufverfolgung ab oder legt sie fest.

Methoden

Name Beschreibung
Close()

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Ausgabedatenstrom geschlossen, sodass er keine Ablaufverfolgungs- oder Debugausgabe mehr empfängt.
CreateObjRef(Type)

Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird.

(Geerbt von MarshalByRefObject)
Dispose()

Gibt alle vom TraceListenerverwendeten Ressourcen frei.
Dispose(Boolean)

Gibt die nicht verwalteten Ressourcen frei, die von den TraceListener verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei.
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
Fail(String, String)

Gibt eine Fehlermeldung und eine detaillierte Fehlermeldung an den Listener aus, den Sie beim Implementieren der TraceListener Klasse erstellen.
Fail(String)

Gibt eine Fehlermeldung an den Listener aus, den Sie beim Implementieren der TraceListener Klasse erstellen.
Flush()

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Ausgabepuffer geleert.
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetLifetimeService()
Veraltet.

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert.

(Geerbt von MarshalByRefObject)
GetSupportedAttributes()

Ruft die benutzerdefinierten Attribute ab, die vom Ablaufverfolgungslistener unterstützt werden.
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
InitializeLifetimeService()
Veraltet.

Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern.

(Geerbt von MarshalByRefObject)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject Objekts.

(Geerbt von MarshalByRefObject)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Schreibt Ablaufverfolgungsinformationen, ein Datenobjekt und Ereignisinformationen in die listenerspezifische Ausgabe.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Schreibt Ablaufverfolgungsinformationen, ein Array von Datenobjekten und Ereignisinformationen in die listenerspezifische Ausgabe.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Schreibt Ablaufverfolgungsinformationen, ein formatiertes Array von Objekten und Ereignisinformationen in die spezifische Ausgabe des Listeners.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Schreibt Ablaufverfolgungsinformationen, eine Nachricht und Ereignisinformationen in die spezifische Ausgabe des Listeners.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)

Schreibt Ablaufverfolgungs- und Ereignisinformationen in die spezifische Ausgabe des Listeners.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)

Schreibt Ablaufverfolgungsinformationen, eine Nachricht, eine zugehörige Aktivitätsidentität und Ereignisinformationen in die spezifische Ausgabe des Listeners.
Write(Object, String)

Schreibt einen Kategorienamen und den Wert der Methode des Objekts ToString() in den Listener, den Sie beim Implementieren der TraceListener Klasse erstellen.
Write(Object)

Schreibt den Wert der Methode des Objekts ToString() in den Listener, den Sie beim Implementieren der TraceListener Klasse erstellen.
Write(String, String)

Schreibt einen Kategorienamen und eine Nachricht in den Listener, den Sie beim Implementieren der TraceListener Klasse erstellen.
Write(String)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die angegebene Nachricht in den Listener geschrieben, den Sie in der abgeleiteten Klasse erstellen.
WriteIndent()

Schreibt den Einzug in den Listener, den Sie beim Implementieren dieser Klasse erstellen, und setzt die NeedIndent Eigenschaft auf false.
WriteLine(Object, String)

Schreibt einen Kategorienamen und den Wert der Methode des Objekts ToString() in den Listener, den Sie beim Implementieren der TraceListener Klasse erstellen, gefolgt von einem Zeilenterminator.
WriteLine(Object)

Schreibt den Wert der Methode des Objekts ToString() in den Listener, den Sie beim Implementieren der TraceListener Klasse erstellen, gefolgt von einem Zeilenterminator.
WriteLine(String, String)

Schreibt einen Kategorienamen und eine Nachricht in den Listener, den Sie beim Implementieren der TraceListener Klasse erstellen, gefolgt von einem Zeilenterminator.
WriteLine(String)

Wenn sie in einer abgeleiteten Klasse überschrieben werden, wird eine Nachricht in den Listener geschrieben, den Sie in der abgeleiteten Klasse erstellen, gefolgt von einem Zeilenterminator.

Gilt für:

Threadsicherheit

Dieser Typ ist threadsicher.

Weitere Informationen