DelimitedListTraceListener Klasse

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.TextWriterTraceListener.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Leitet die Ablaufverfolgungs- oder Debugausgabe an einen Textwriter, z. B. einen Streamwriter, oder in einen Stream, z. B. einen Dateistream.

public ref class DelimitedListTraceListener : System::Diagnostics::TextWriterTraceListener

public class DelimitedListTraceListener : System.Diagnostics.TextWriterTraceListener

type DelimitedListTraceListener = class
    inherit TextWriterTraceListener

Public Class DelimitedListTraceListener
Inherits TextWriterTraceListener

Vererbung

Object

MarshalByRefObject

TraceListener

TextWriterTraceListener

DelimitedListTraceListener

Vererbung

Object

TraceListener

TextWriterTraceListener

DelimitedListTraceListener

Hinweise

Die Ablaufverfolgungsausgabe befindet sich in einem durch Trennzeichen getrennten Textformat, das das durch die Delimiter Eigenschaft angegebene Trennzeichen verwendet. Das Trennzeichen wird verwendet, um jedes Feld in einer Ausgabezeile zu beenden. Um beispielsweise die Ablaufverfolgungsausgabe in einer Microsoft Excel Kalkulationstabelle anzuzeigen, können Sie ein Komma (",") als Trennzeichen angeben und eine kommatrennte Wertdatei (CSV) erstellen.

Wichtig

Dieser Typ implementiert die IDisposable-Schnittstelle. Nach Abschluss der Verwendung sollten Sie den Typ entweder direkt oder indirekt löschen. Um den Typ direkt zu entsorgen, rufen Sie die Dispose Methode in einemtry/catch Block auf. Zum indirekten Löschen verwenden Sie ein Sprachkonstrukt wie using (in C#) oder Using (in Visual Basic). Weitere Informationen finden Sie im Abschnitt „Verwenden eines Objekts, das IDisposable implementiert“ des Themas „Die IDisposable-Schnittstelle“.

Sie können einen DelimitedListTraceListener Code erstellen. Alternativ können Sie in .NET Framework Apps nur eine DelimitedListTraceListener über die Anwendungskonfigurationsdatei aktivieren oder deaktivieren und dann die konfigurierte DelimitedListTraceListener Anwendung verwenden.

Hinweis

Die DelimitedListTraceListener Trennzeichen werden nur mit den Methoden getrennt, die mit den Namen beginnen Trace, z DelimitedListTraceListener.TraceEvent . B. oder Trace.TraceWarning. Ablaufverfolgungsdaten, die mithilfe der Debug.Write TextWriterTraceListener.WriteLine Methoden ausgegeben werden, werden nicht getrennt.

Um eine DelimitedListTraceListener in einer .NET Framework-App zu konfigurieren, bearbeiten Sie die Konfigurationsdatei, die dem Namen Ihrer Anwendung entspricht. In dieser Datei können Sie einen Listener hinzufügen, die Eigenschaften für einen Listener festlegen oder einen Listener entfernen. Die Konfigurationsdatei sollte wie im folgenden Beispiel dargestellt formatiert werden:

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="delimitedListener"   
          type="System.Diagnostics.DelimitedListTraceListener"   
          delimiter=","   
          initializeData="delimitedOutput.csv"   
          traceOutputOptions="ProcessId, DateTime" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>  

Hinweis

Wenn Sie versuchen, in eine Datei zu schreiben, die verwendet oder nicht verfügbar ist, wird der Dateiname automatisch durch eine GUID präfixiert.

Hinweis

Listener sollen von Methoden der Debug, Traceund TraceSource Klassen verwendet werden, um Ablaufverfolgungsinformationen zu schreiben. Listener-Methoden, außer für Konstruktoren, sollten nicht direkt aus Anwendungscode aufgerufen werden.

Konstruktoren

DelimitedListTraceListener(Stream)	Initialisiert eine neue Instanz der DelimitedListTraceListener-Klasse, die in den angegebenen Ausgabestream schreibt.
DelimitedListTraceListener(Stream, String)	Initialisiert eine neue Instanz der DelimitedListTraceListener-Klasse, die in den angegebenen Ausgabestream schreibt und den angegebenen Namen hat.
DelimitedListTraceListener(String)	Initialisiert eine neue Instanz der DelimitedListTraceListener-Klasse, die in die angegebene Datei schreibt.
DelimitedListTraceListener(String, String)	Initialisiert eine neue Instanz der DelimitedListTraceListener-Klasse, die in die angegebene Datei schreibt und den angegebenen Namen hat.
DelimitedListTraceListener(TextWriter)	Initialisiert eine neue Instanz der DelimitedListTraceListener-Klasse, die in den angegebenen Textwriter schreibt.
DelimitedListTraceListener(TextWriter, String)	Initialisiert eine neue Instanz der DelimitedListTraceListener-Klasse, die in den angegebenen Textwriter schreibt und den angegebenen Namen hat.

Eigenschaften

Attributes	Ruft die benutzerdefinierten Attribute für Ablaufverfolgungslistener ab, die in der Anwendungskonfigurationsdatei definiert sind. (Geerbt von TraceListener)
Delimiter	Ruft das Trennzeichen für die Liste mit Trennzeichen ab oder legt dieses fest.
Filter	Ruft den Ablaufverfolgungsfilter für den Ablaufverfolgungslistener ab oder legt diesen fest. (Geerbt von TraceListener)
IndentLevel	Ruft die Einzugsebene ab oder legt diese fest. (Geerbt von TraceListener)
IndentSize	Ruft die Anzahl der Leerzeichen in einem Einzug ab oder legt diese fest. (Geerbt von TraceListener)
IsThreadSafe	Ruft einen Wert ab, der angibt, ob der Ablaufverfolgungslistener threadsicher ist. (Geerbt von TraceListener)
Name	Ruft einen Namen für diesen TraceListener ab oder legt diesen fest. (Geerbt von TraceListener)
NeedIndent	Ruft einen Wert ab, der einen Einzug für die Ausgabe angibt, oder legt diesen fest. (Geerbt von TraceListener)
TraceOutputOptions	Ruft die Optionen für die Ablaufverfolgungsausgabe ab oder legt diese fest. (Geerbt von TraceListener)
Writer	Ruft den Textwriter ab, der die Ablaufverfolgungs- oder Debugausgabe empfängt. (Geerbt von TextWriterTraceListener)

Methoden

Close()	Schließt den Writer, sodass dieser keine Ablaufverfolgungs- oder Debugausgabe mehr empfängt. (Geerbt von TextWriterTraceListener)
CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
Dispose()	Gibt alle vom TraceListener verwendeten Ressourcen frei. (Geerbt von TraceListener)
Dispose(Boolean)	Gibt dieses TextWriterTraceListener-Objekt frei. (Geerbt von TextWriterTraceListener)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
Fail(String)	Gibt eine Fehlermeldung an den Listener aus, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener)
Fail(String, String)	Gibt eine Fehlermeldung sowie eine detaillierte Fehlermeldung an den Listener aus, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener)
Flush()	Leert den Ausgabepuffer von Writer. (Geerbt von TextWriterTraceListener)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Veraltet. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetSupportedAttributes()	Gibt das benutzerdefinierte Konfigurationsdateiattribut zurück, das vom Ablaufverfolgungslistener mit Trennzeichen unterstützt wird.
GetSupportedAttributes()	Ruft die vom Ablaufverfolgungslistener unterstützten benutzerdefinierten Attribute ab. (Geerbt von TraceListener)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Veraltet. Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie des 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 Ausgabedatei oder den Stream.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Schreibt Ablaufverfolgungsinformationen, ein Array von Datenobjekten und Ereignisinformationen in die Ausgabedatei oder den Stream.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Schreibt Ablaufverfolgungs- und Ereignisinformationen in die spezifische Ausgabe des Listeners. (Geerbt von TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Schreibt Ablaufverfolgungsinformationen, eine Meldung und Ereignisinformationen in die Ausgabedatei oder den Stream.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Schreibt Ablaufverfolgungsinformationen, ein formatiertes Array von Objekten und Ereignisinformationen in die Ausgabedatei oder den Stream.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Schreibt Ablaufverfolgungsinformationen, eine Meldung, eine verwandte Aktivitätsidentität und Ereignisinformationen in die spezifische Ausgabe des Listeners. (Geerbt von TraceListener)
Write(Object)	Schreibt den Wert der ToString()-Methode des Objekts in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener)
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. (Geerbt von TraceListener)
Write(String)	Schreibt eine Meldung in den Writer dieser Instanz. (Geerbt von TextWriterTraceListener)
Write(String, String)	Schreibt einen Kategorienamen und eine Meldung in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener)
WriteIndent()	Schreibt den Einzug in den Listener, den sie bei der Implementierung dieser Klasse erstellen, und setzt die NeedIndent-Eigenschaft auf false zurück. (Geerbt von TraceListener)
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. (Geerbt von TraceListener)
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. (Geerbt von TraceListener)
WriteLine(String)	Schreibt eine Meldung, gefolgt von einem Zeichen für den Zeilenabschluss, in den Writer dieser Instanz. Der Standardzeilenabschluss ist ein Wagenrücklauf, gefolgt von einem Zeilenvorschub (\r\n). (Geerbt von TextWriterTraceListener)
WriteLine(String, String)	Schreibt einen Kategorienamen und eine Meldung gefolgt von einem Zeilenabschluss in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener)