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

TextWriterTraceListener-Klasse

 

Veröffentlicht: Oktober 2016

Leitet Ablaufverfolgungs- oder um eine TextWriter oder ein Stream, wie z. B. FileStream.

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

System.Object
  System.MarshalByRefObject
    System.Diagnostics.TraceListener
      System.Diagnostics.TextWriterTraceListener
        System.Diagnostics.ConsoleTraceListener
        System.Diagnostics.DelimitedListTraceListener
        System.Diagnostics.EventSchemaTraceListener
        System.Diagnostics.XmlWriterTraceListener

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

NameBeschreibung
System_CAPS_pubmethodTextWriterTraceListener()

Initialisiert eine neue Instanz der TextWriterTraceListener-Klasse mit TextWriter Empfänger der Ausgabe.

System_CAPS_pubmethodTextWriterTraceListener(Stream)

Initialisiert eine neue Instanz der TextWriterTraceListener -Klasse unter Verwendung des Streams als Empfänger der Debug- oder Ablaufverfolgungsausgabe.

System_CAPS_pubmethodTextWriterTraceListener(Stream, String)

Initialisiert eine neue Instanz der TextWriterTraceListener -Klasse mit dem angegebenen Namen unter Verwendung des Streams als Empfänger der Debug- oder Ablaufverfolgungsausgabe.

System_CAPS_pubmethodTextWriterTraceListener(String)

Initialisiert eine neue Instanz der TextWriterTraceListener -Klasse unter Verwendung der das als Empfänger der Debug- oder Ablaufverfolgungsausgabe.

System_CAPS_pubmethodTextWriterTraceListener(String, String)

Initialisiert eine neue Instanz der TextWriterTraceListener -Klasse mit dem angegebenen Namen unter Verwendung der das als Empfänger der Debug- oder Ablaufverfolgungsausgabe.

System_CAPS_pubmethodTextWriterTraceListener(TextWriter)

Initialisiert eine neue Instanz der TextWriterTraceListener -Klasse mit dem angegebenen Writer als Empfänger der Ablaufverfolgung oder Debugausgabe.

System_CAPS_pubmethodTextWriterTraceListener(TextWriter, String)

Initialisiert eine neue Instanz der TextWriterTraceListener -Klasse mit dem angegebenen Namen unter Verwendung des angegebenen Writers als Empfänger der Ablaufverfolgung oder Debugausgabe.

NameBeschreibung
System_CAPS_pubpropertyAttributes

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

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.

NameBeschreibung
System_CAPS_pubmethodClose()

Schließt die Writer , damit es nicht mehr empfängt, Ablaufverfolgungs- oder debuggingausgabe.(Überschreibt TraceListener.Close().)

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.(Überschreibt TraceListener.Dispose(Boolean).)

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 zu dem Versuch, 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.(Überschreibt TraceListener.Flush().)

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()

Ruft die vom Ablaufverfolgungslistener unterstützten benutzerdefinierten Attribute ab.(Geerbt von „TraceListener“.)

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 spezifische Ausgabe des Listeners.(Geerbt von „TraceListener“.)

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

Schreibt Ablaufverfolgungsinformationen, ein Array von Datenobjekten und Ereignisinformationen in die spezifische Ausgabe des Listeners.(Geerbt von „TraceListener“.)

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 spezifische Ausgabe des Listeners.(Geerbt von „TraceListener“.)

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

Schreibt Ablaufverfolgungsinformationen, ein formatiertes Array von Objekten und Ereignisinformationen in die spezifische Ausgabe des Listeners.(Geerbt von „TraceListener“.)

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.(Überschreibt TraceListener.Write(String).)

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).(Überschreibt TraceListener.WriteLine(String).)

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 TextWriterTraceListener -Klasse stellt die Writer -Eigenschaft zum Abrufen oder Festlegen des Textwriters, empfängt der Protokollierung oder Debugausgabe.

System_CAPS_importantWichtig

Dieser Typ implementiert die IDisposable Schnittstelle. Wenn Sie mit dem Datentyp haben, sollten Sie es entweder direkt oder indirekt freigeben. Damit des Typs direkt freigegeben werden, rufen Sie seine Dispose -Methode in eine try/catch Block. Verwenden, um es indirekt freigegeben werden, z. B. ein Sprachkonstrukt using (in c#) oder Using (in Visual Basic). Weitere Informationen finden Sie im Abschnitt "Verwenden eines Objekts, die implementiert IDisposable" in der IDisposable Thema zur Schnittstelle.

Diese Klasse stellt auch Methoden zum Close der Writer so, dass er nicht mehr empfängt, Ablaufverfolgungs- oder Debugausgabe zu Flush der Ausgabepuffer für die Writer, und Write eine Nachricht an die Writer.

Sie müssen die Ablaufverfolgungs- oder um einen Ablaufverfolgungslistener verwenden aktivieren. Die folgende Syntax ist compilerspezifisch. Wenn Sie einen anderen Compiler als c# oder Visual Basic verwenden, finden Sie in der Dokumentation zum Compiler.

  • Fügen Sie zum Aktivieren des Debuggens in c#, die /d:DEBUG Flag in der Compilerbefehlszeile beim Kompilieren des Codes, oder Sie fügen #define DEBUG am Anfang der Datei. Fügen Sie in Visual Basic die /d:DEBUG=True Flag in der Compilerbefehlszeile.

  • Fügen Sie zum Aktivieren der Ablaufverfolgung in c# die /d:TRACE Flag in der Compilerbefehlszeile beim Kompilieren des Codes hinzufügen oder #define TRACE am Anfang der Datei. Fügen Sie in Visual Basic die /d:TRACE=True Flag in der Compilerbefehlszeile.

Um einen Ablaufverfolgungslistener hinzufügen, bearbeiten Sie die Konfigurationsdatei, die den Namen der Anwendung entspricht. In dieser Datei können Sie einen Listener hinzufügen und den Typ und Parameter festlegen, einen Listener entfernen oder deaktivieren alle Listener, die zuvor durch die Anwendung festgelegt. Die Konfigurationsdatei sollte 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>
System_CAPS_noteHinweis

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

Das folgende Beispiel implementiert eine Instanz der TextWriterTraceListener -Klasse, verwendet eine StreamWriter aufgerufen myOutputWriter zum Schreiben in eine Datei namens TestFile.txt. Im Beispiel wird zuerst eine Datei für die Ausgabe erstellt. Anschließend es erstellt die StreamWriter für den ersten TextWriter, der Ausgabedatei zugeordnet und fügt dieses der Listeners. Dann gibt der Code eine Textzeile in die Datei. Im Beispiel leert schließlich den Ausgabepuffer.

Nach dem Ausführen dieses Beispiels können Sie öffnen die TestFile.txt Datei, um die Ausgabe anzuzeigen.

public class Sample
{

public static int Main(string[] args) {
    // Create a file for output named TestFile.txt.
    Stream myFile = File.Create("TestFile.txt");

    /* Create a new text writer using the output stream, and add it to
     * the trace listeners. */
    TextWriterTraceListener myTextListener = new 
       TextWriterTraceListener(myFile);
    Trace.Listeners.Add(myTextListener);

    // Write output to the file.
    Trace.Write("Test output ");


    // Flush the output.
    Trace.Flush(); 

    return 0;
 }

}

.NET Framework
Verfügbar seit 1.1

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: