Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

DelimitedListTraceListener-Klasse

 

Veröffentlicht: Oktober 2016

Leitet Ablaufverfolgungs- oder mit einem TextWriter, z. B. einen StreamWriter, oder in einen Stream, z. B. einen Dateistream.

Namespace:   System.Diagnostics
Assembly:  System (in System.dll)

System.Object
  System.MarshalByRefObject
    System.Diagnostics.TraceListener
      System.Diagnostics.TextWriterTraceListener
        System.Diagnostics.DelimitedListTraceListener

[HostProtectionAttribute(SecurityAction.LinkDemand, Synchronization = true)]
public class DelimitedListTraceListener : TextWriterTraceListener

NameBeschreibung
System_CAPS_pubmethodDelimitedListTraceListener(Stream)

Initialisiert eine neue Instanz der DelimitedListTraceListener -Klasse, die in den angegebenen Ausgabestream schreibt.

System_CAPS_pubmethodDelimitedListTraceListener(Stream, String)

Initialisiert eine neue Instanz der DelimitedListTraceListener -Klasse, die in den angegebenen Ausgabestream schreibt und den angegebenen Namen aufweist.

System_CAPS_pubmethodDelimitedListTraceListener(String)

Initialisiert eine neue Instanz der DelimitedListTraceListener -Klasse, die in die angegebene Datei schreibt.

System_CAPS_pubmethodDelimitedListTraceListener(String, String)

Initialisiert eine neue Instanz der DelimitedListTraceListener -Klasse, die in die angegebene Datei schreibt und den angegebenen Namen aufweist.

System_CAPS_pubmethodDelimitedListTraceListener(TextWriter)

Initialisiert eine neue Instanz der DelimitedListTraceListener -Klasse, die in den angegebenen Textwriter schreibt.

System_CAPS_pubmethodDelimitedListTraceListener(TextWriter, String)

Initialisiert eine neue Instanz der DelimitedListTraceListener -Klasse, die an den angegebenen Textwriter schreibt und den angegebenen Namen aufweist.

NameBeschreibung
System_CAPS_pubpropertyAttributes

Ruft die benutzerdefinierten Attribute für Ablaufverfolgungslistener ab, die in der Anwendungskonfigurationsdatei definiert sind.(Geerbt von „TraceListener“.)

System_CAPS_pubpropertyDelimiter

Ruft ab oder legt die Trennzeichen für die durch Trennzeichen getrennte Liste.

System_CAPS_pubpropertyFilter

Ruft den Ablaufverfolgungsfilter für den Ablaufverfolgungslistener ab und legt diesen fest.(Geerbt von „TraceListener“.)

System_CAPS_pubpropertyIndentLevel

Ruft die Einzugsebene ab oder legt diese fest.(Geerbt von „TraceListener“.)

System_CAPS_pubpropertyIndentSize

Ruft die Anzahl der Leerzeichen in einem Einzug ab oder legt diese fest.(Geerbt von „TraceListener“.)

System_CAPS_pubpropertyIsThreadSafe

Ruft einen Wert ab, der angibt, ob der Ablaufverfolgungslistener threadsicher ist.(Geerbt von „TraceListener“.)

System_CAPS_pubpropertyName

Ruft einen Namen für diesen TraceListener ab oder legt diesen fest.(Geerbt von „TraceListener“.)

System_CAPS_protpropertyNeedIndent

Ruft einen Wert ab, der einen Einzug für die Ausgabe angibt, oder legt diesen fest.(Geerbt von „TraceListener“.)

System_CAPS_pubpropertyTraceOutputOptions

Ruft die Optionen für die Ablaufverfolgungsausgabe ab oder legt diese fest.(Geerbt von „TraceListener“.)

System_CAPS_pubpropertyWriter

Ruft ab oder legt den TextWriter, der die Ablaufverfolgung oder Debuggen Ausgabe empfängt.(Geerbt von „TextWriterTraceListener“.)

NameBeschreibung
System_CAPS_pubmethodClose()

Schließt die Writer , damit es nicht mehr empfängt, Ablaufverfolgungs- oder debuggingausgabe.(Geerbt von „TextWriterTraceListener“.)

System_CAPS_pubmethodCreateObjRef(Type)

Erstellt ein Objekt, das alle relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt verwendet die enthält.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodDispose()

Gibt alle vom TraceListener verwendeten Ressourcen frei.(Geerbt von „TraceListener“.)

System_CAPS_protmethodDispose(Boolean)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Verwirft diese TextWriterTraceListener Objekt.(Geerbt von „TextWriterTraceListener“.)

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_pubmethodFail(String)

Gibt eine Fehlermeldung an den Listener aus, den Sie beim Implementieren der TraceListener-Klasse erstellen.(Geerbt von „TraceListener“.)

System_CAPS_pubmethodFail(String, String)

Gibt eine Fehlermeldung sowie eine detaillierte Fehlermeldung an den Listener aus, den Sie beim Implementieren der TraceListener-Klasse erstellen.(Geerbt von „TraceListener“.)

System_CAPS_protmethodFinalize()

Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Geerbt von „Object“.)

System_CAPS_pubmethodFlush()

Leert den Ausgabepuffer für die Writer.(Geerbt von „TextWriterTraceListener“.)

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetLifetimeService()

Ruft das Dienstobjekt für aktuellen Lebensdauer, das steuert, die lebensdauerrichtlinie für diese Instanz ab.(Geerbt von „MarshalByRefObject“.)

System_CAPS_protmethodGetSupportedAttributes()

Gibt die vom Ablaufverfolgungslistener mit Trennzeichen unterstützt benutzerdefinierte Konfigurationsdateiattribut zurück.(Überschreibt TraceListener.GetSupportedAttributes().)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodInitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.(Geerbt von „MarshalByRefObject“.)

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von „Object“.)

System_CAPS_protmethodMemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject Objekt.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

System_CAPS_pubmethodTraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Schreibt Ablaufverfolgungsinformationen, ein Datenobjekt und Ereignisinformationen in die Ausgabedatei oder den Stream.(Überschreibt TraceListener.TraceData(TraceEventCache, String, TraceEventType, Int32, Object).)

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

Schreibt Ablaufverfolgungsinformationen, ein Array von Datenobjekten und Ereignisinformationen in die Ausgabedatei oder den Stream.(Überschreibt TraceListener.TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]).)

System_CAPS_pubmethodTraceEvent(TraceEventCache, String, TraceEventType, Int32)

Schreibt Ablaufverfolgungs- und Ereignisinformationen in die spezifische Ausgabe des Listeners.(Geerbt von „TraceListener“.)

System_CAPS_pubmethodTraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Schreibt Ablaufverfolgungsinformationen, eine Meldung und Ereignisinformationen in die Ausgabedatei oder den Stream.(Überschreibt TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String).)

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

Schreibt Ablaufverfolgungsinformationen, ein formatiertes Array von Objekten und Ereignisinformationen in die Ausgabedatei oder den Stream.(Überschreibt TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]).)

System_CAPS_pubmethodTraceTransfer(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“.)

System_CAPS_pubmethodWrite(Object)

Schreibt den Wert der ToString-Methode des Objekts in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen.(Geerbt von „TraceListener“.)

System_CAPS_pubmethodWrite(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“.)

System_CAPS_pubmethodWrite(String)

Schreibt eine Meldung in dieser Instanz Writer.(Geerbt von „TextWriterTraceListener“.)

System_CAPS_pubmethodWrite(String, String)

Schreibt einen Kategorienamen und eine Meldung in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen.(Geerbt von „TraceListener“.)

System_CAPS_protmethodWriteIndent()

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“.)

System_CAPS_pubmethodWriteLine(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“.)

System_CAPS_pubmethodWriteLine(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“.)

System_CAPS_pubmethodWriteLine(String)

Schreibt eine Meldung in dieser Instanz Writer gefolgt von einem Zeilenabschlusszeichen. Das Standardzeilenabschlusszeichen ist ein Wagenrücklaufzeichen gefolgt von einem Zeilenvorschub (\r\n).(Geerbt von „TextWriterTraceListener“.)

System_CAPS_pubmethodWriteLine(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“.)

Die Ablaufverfolgungsausgabe liegt in einem Textformat mit Trennzeichen vor, das das durch die Delimiter-Eigenschaft angegebene Trennzeichen verwendet. Das Trennzeichen wird verwendet, um jedes Feld in einer Zeile der Ausgabe zu beenden. Angenommen, um die Ablaufverfolgungsausgabe in Microsoft Excel-Arbeitsblatt anzuzeigen, könnten, geben Sie ein Komma (",") als Trennzeichen und erstellen Sie eine Datei mit kommagetrennten Werten (CSV).

System_CAPS_importantWichtig

IDisposable Schnittstelle. Wenn Sie den Typ nicht mehr verwenden, sollten Sie ihn entweder direkt oder indirekt freigeben. Damit des Typs direkt freigegeben werden, rufen Sie seine Dispose -Methode in einetry/catch Block. Um es indirekt freizugeben, verwenden Sie ein Sprachkonstrukt wie z. B. using (in c#) oder Using (in Visual Basic). Weitere Informationen finden Sie im Abschnitt "Verwenden eines Objekts, welches IDisposable implementiert" im IDisposable Themenabschnitt zur Schnittstelle.

Sie aktivieren oder deaktivieren können eine DelimitedListTraceListener über die Konfigurationsdatei der Anwendung verwenden und dann den konfigurierten DelimitedListTraceListener in Ihrer Anwendung. Alternativ können Sie erstellen eine DelimitedListTraceListener in Ihrem Code.

System_CAPS_noteHinweis

Die DelimitedListTraceListener begrenzt nur Text, der ausgegeben wird, mithilfe der Methoden, deren Namen mit dem Wort ab Trace, wie z. B. DelimitedListTraceListener.TraceEvent oder Trace.TraceWarning. Ablaufverfolgungsdaten, die ausgegeben wird, mithilfe der Debug.Write und TextWriterTraceListener.WriteLine Methoden ist nicht begrenzt.

So konfigurieren Sie eine DelimitedListTraceListener, die Konfigurationsdatei bearbeiten, die den Namen der Anwendung entspricht. In dieser Datei können Sie einen Listener hinzufügen, legen Sie die Eigenschaften für einen Listener oder einen Listener entfernen. Die Konfigurationsdatei sollte formatiert werden, wie im folgenden Beispiel gezeigt:

<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>
System_CAPS_noteHinweis

Wenn Sie versuchen, in eine Datei schreiben, die verwendet oder nicht verfügbar ist, wird der Dateinamen automatisch eine GUID vorangestellt.

System_CAPS_noteHinweis

Listener sollen von Methoden verwendet werden die Debug, Trace, und TraceSource Klassen, um Ablaufverfolgungsinformationen zu schreiben. Listener-Methoden, mit Ausnahme der Konstruktoren, sollte nicht direkt von Anwendungscode aufgerufen werden.

.NET Framework
Verfügbar seit 2.0

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: