TextWriterTraceListener Klasse

Definition

Leitet die Ablaufverfolgungs- oder Debugausgabe an einen TextWriter oder Stream, z. B. FileStream.Directs tracing or debugging output to a TextWriter or to a Stream, such as FileStream.

public ref class TextWriterTraceListener : System::Diagnostics::TraceListener
public class TextWriterTraceListener : System.Diagnostics.TraceListener
type TextWriterTraceListener = class
    inherit TraceListener
Public Class TextWriterTraceListener
Inherits TraceListener
Vererbung
TextWriterTraceListener
Vererbung
TextWriterTraceListener
Abgeleitet

Beispiele

Im folgenden Beispiel wird eine Instanz der- TextWriterTraceListener Klasse implementiert, die eine StreamWriter aufgerufene myOutputWriter zum Schreiben in eine Datei mit dem Namen verwendet TestFile.txt .The following example implements an instance of the TextWriterTraceListener class that uses a StreamWriter called myOutputWriter to write to a file named TestFile.txt. Zunächst wird im Beispiel eine Datei für die Ausgabe erstellt.First the example creates a file for output. Anschließend StreamWriter wird der für den ersten TextWriter erstellt, der Ausgabedatei zugewiesen und dem hinzugefügt Listeners .Then it creates the StreamWriter for the first text writer, assigns it the output file, and adds it to the Listeners. Anschließend gibt der Code eine Textzeile in die Datei aus.Then, the code outputs one line of text to the file. Schließlich leert das Beispiel den Ausgabepuffer.Finally, the example flushes the output buffer.

Nachdem Sie dieses Beispiel ausgeführt haben, können Sie die Datei öffnen, TestFile.txt um die Ausgabe anzuzeigen.After running this sample, you can open the TestFile.txt file to see the output.

void main()
{
   #if defined(TRACE)
   // 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 = 
      gcnew TextWriterTraceListener( myFile );
   Trace::Listeners->Add( myTextListener );
  
   // Write output to the file.
   Trace::Write( "Test output " );
  
   // Flush the output.
   Trace::Flush();
   Trace::Close();
   #endif
}
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;
 }
}
Public Class Sample
    
    Public Shared Sub Main()
        ' Create a file for output named TestFile.txt.
        Dim myFile As Stream = File.Create("TestFile.txt")
        
        ' Create a new text writer using the output stream, and add it to
        ' the trace listeners. 
        Dim myTextListener As New TextWriterTraceListener(myFile)
        Trace.Listeners.Add(myTextListener)

        
        ' Write output to the file.
        Trace.Write("Test output ")
        
        ' Flush the output.
        Trace.Flush() 

        System.Environment.ExitCode = 0
    End Sub

End Class

Hinweise

Die- TextWriterTraceListener Klasse stellt die- Writer Eigenschaft bereit, um den TextWriter, der die Ablaufverfolgungs-oder Debugausgabe empfängt, zu erhaltenThe TextWriterTraceListener class provides the Writer property to get or set the text writer that receives the tracing or debugging output.

Wichtig

Dieser Typ implementiert die IDisposable-Schnittstelle.This type implements the IDisposable interface. Nach Abschluss der Verwendung sollten Sie den Typ entweder direkt oder indirekt löschen.When you have finished using the type, you should dispose of it either directly or indirectly. Zum direkten Löschen des Typs rufen Sie seine Dispose-Methode in einem try/catch-Block auf.To dispose of the type directly, call its Dispose method in a try/catch block. Zum indirekten Löschen verwenden Sie ein Sprachkonstrukt wie using (in C#) oder Using (in Visual Basic).To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Weitere Informationen finden Sie im Abschnitt „Verwenden eines Objekts, das IDisposable implementiert“ des Themas „Die IDisposable-Schnittstelle“.For more information, see the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Diese Klasse stellt auch Methoden für bereit, Close Writer sodass Sie keine Ablaufverfolgungs-oder Debugausgaben mehr an Flush den Ausgabepuffer für den Writer und Write eine Meldung an die empfängt Writer .This class also provides methods to Close the Writer so that it no longer receives tracing or debugging output, to Flush the output buffer for the Writer, and to Write a message to the Writer.

Sie müssen die Ablauf Verfolgung oder das Debuggen für die Verwendung eines AblaufverfolgungsYou must enable tracing or debugging to use a trace listener. Die folgende Syntax ist compilerspezifisch.The following syntax is compiler specific. Wenn Sie andere Compiler als c# oder Visual Basic verwenden, finden Sie in der Dokumentation Ihres Compiler weitere Informationen.If you use compilers other than C# or Visual Basic, refer to the documentation for your compiler.

  • Um das Debuggen in c# zu aktivieren, fügen Sie das /d:DEBUG Flag der Compilerbefehlszeile hinzu, wenn Sie den Code kompilieren, oder Sie können #define DEBUG am Anfang der Datei hinzufügen.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 der /d:DEBUG=True Compilerbefehlszeile das-Flag hinzu.In Visual Basic, add the /d:DEBUG=True flag to the compiler command line.

  • Um die Ablauf Verfolgung in c# zu aktivieren, fügen /d:TRACE Sie das Flag der Compilerbefehlszeile hinzu, wenn Sie den Code kompilieren, oder fügen Sie #define TRACE am Anfang der Datei hinzu.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 der /d:TRACE=True Compilerbefehlszeile das-Flag hinzu.In Visual Basic, add the /d:TRACE=True flag to the compiler command line.

Wenn Sie einen Ablaufverfolgungslistener hinzufügen möchten, bearbeiten Sie die Konfigurationsdatei, die dem Namen der Anwendung entspricht.To add a trace listener, edit the configuration file that corresponds to the name of your application. Innerhalb dieser Datei können Sie einen Listener hinzufügen, seinen Typ festlegen und dessen Parameter festlegen, einen Listener entfernen oder alle Listener löschen, die zuvor von der Anwendung festgelegt wurden.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 wie im folgenden Beispiel formatiert sein.The configuration file should be formatted like 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>  

Hinweis

Wenn versucht wird, in eine Datei zu schreiben, die verwendet wird oder nicht verfügbar ist, wird dem Dateinamen automatisch eine GUID vorangestellt.If an attempt is made to write to a file that is in use or unavailable, the file name is automatically prefixed by a GUID.

Konstruktoren

TextWriterTraceListener()

Initialisiert eine neue Instanz der TextWriterTraceListener-Klasse mit TextWriter Empfänger der Ausgabe.Initializes a new instance of the TextWriterTraceListener class with TextWriter as the output recipient.

TextWriterTraceListener(Stream)

Initialisiert eine neue Instanz der TextWriterTraceListener-Klasse mit dem Stream als Empfänger der Debug- oder Ablaufverfolgungsausgabe.Initializes a new instance of the TextWriterTraceListener class, using the stream as the recipient of the debugging and tracing output.

TextWriterTraceListener(Stream, String)

Initialisiert eine neue Instanz der TextWriterTraceListener-Klasse mit dem angegebenen Namen und unter Verwendung des Streams als Empfänger der Debug- oder Ablaufverfolgungsausgabe.Initializes a new instance of the TextWriterTraceListener class with the specified name, using the stream as the recipient of the debugging and tracing output.

TextWriterTraceListener(String)

Initialisiert eine neue Instanz der TextWriterTraceListener-Klasse mit der Datei als Empfänger der Debug- oder Ablaufverfolgungsausgabe.Initializes a new instance of the TextWriterTraceListener class, using the file as the recipient of the debugging and tracing output.

TextWriterTraceListener(String, String)

Initialisiert eine neue Instanz der TextWriterTraceListener-Klasse mit dem angegebenen Namen und unter Verwendung der Datei als Empfänger der Debug- oder Ablaufverfolgungsausgabe.Initializes a new instance of the TextWriterTraceListener class with the specified name, using the file as the recipient of the debugging and tracing output.

TextWriterTraceListener(TextWriter)

Initialisiert eine neue Instanz der TextWriterTraceListener-Klasse mit dem angegebenen Writer als Empfänger der Ablaufverfolgungs- oder Debugausgabe.Initializes a new instance of the TextWriterTraceListener class using the specified writer as recipient of the tracing or debugging output.

TextWriterTraceListener(TextWriter, String)

Initialisiert eine neue Instanz der TextWriterTraceListener-Klasse mit dem angegebenen Namen und unter Verwendung des angegebenen Writers als Empfänger der Ablaufverfolgungs- oder Debugausgabe.Initializes a new instance of the TextWriterTraceListener class with the specified name, using the specified writer as recipient of the tracing or debugging output.

Eigenschaften

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.

(Geerbt von TraceListener)
Filter

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

(Geerbt von TraceListener)
IndentLevel

Ruft die Einzugsebene ab oder legt diese fest.Gets or sets the indent level.

(Geerbt von TraceListener)
IndentSize

Ruft die Anzahl der Leerzeichen in einem Einzug ab oder legt diese fest.Gets or sets the number of spaces in an indent.

(Geerbt von TraceListener)
IsThreadSafe

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

(Geerbt von TraceListener)
Name

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

(Geerbt von TraceListener)
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.

(Geerbt von TraceListener)
TraceOutputOptions

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

(Geerbt von TraceListener)
Writer

Ruft den Textwriter ab, der die Ablaufverfolgungs- oder Debugausgabe empfängt.Gets or sets the text writer that receives the tracing or debugging output.

Methoden

Close()

Schließt den Writer, sodass dieser keine Ablaufverfolgungs- oder Debugausgabe mehr empfängt.Closes the Writer so that it no longer receives tracing or debugging output.

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.

(Geerbt von TraceListener)
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.

(Geerbt von MarshalByRefObject)
Dispose()

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

(Geerbt von TraceListener)
Dispose(Boolean)

Gibt dieses TextWriterTraceListener-Objekt frei.Disposes this TextWriterTraceListener object.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
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.

(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.Emits an error message and a detailed error message to the listener you create when you implement the TraceListener class.

(Geerbt von TraceListener)
Flush()

Leert den Ausgabepuffer von Writer.Flushes the output buffer for the Writer.

GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
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.

(Geerbt von MarshalByRefObject)
GetSupportedAttributes()

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

(Geerbt von TraceListener)
GetType()

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

(Geerbt von Object)
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.

(Geerbt von MarshalByRefObject)
MemberwiseClone()

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

(Geerbt von Object)
MemberwiseClone(Boolean)

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

(Geerbt von MarshalByRefObject)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von 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.

(Geerbt von TraceListener)
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.

(Geerbt von TraceListener)
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.

(Geerbt von TraceListener)
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.

(Geerbt von TraceListener)
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.

(Geerbt von TraceListener)
TraceTransfer(TraceEventCache, String, Int32, String, Guid)

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

(Geerbt von TraceListener)
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.

(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.Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

(Geerbt von TraceListener)
Write(String)

Schreibt eine Meldung in den Writer dieser Instanz.Writes a message to this instance's Writer.

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.

(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.Writes the indent to the listener you create when you implement this class, and resets the NeedIndent property to false.

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

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

(Geerbt von TraceListener)
WriteLine(String)

Schreibt eine Meldung, gefolgt von einem Zeichen für den Zeilenabschluss, in den Writer dieser Instanz.Writes a message to this instance's Writer followed by a line terminator. Der Standardzeilenabschluss ist ein Wagenrücklauf, gefolgt von einem Zeilenvorschub (\r\n).The default line terminator is a carriage return followed by a line feed (\r\n).

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.

(Geerbt von TraceListener)

Gilt für:

Weitere Informationen