TextWriterTraceListener Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Directs tracing or debugging output to a TextWriter or to a Stream, such as FileStream.
public ref class TextWriterTraceListener : System::Diagnostics::TraceListenerpublic class TextWriterTraceListener : System.Diagnostics.TraceListenertype TextWriterTraceListener = class
inherit TraceListenerPublic Class TextWriterTraceListener
Inherits TraceListener- Vererbung
- Vererbung
- Abgeleitet
Beispiele
Im folgenden Beispiel wird eine Instanz der Klasse implementiert, die TextWriterTraceListener einen StreamWriter Aufruf myOutputWriter zum Schreiben in eine Datei namens TestFile.txtverwendet. Im ersten Beispiel wird eine Datei für die Ausgabe erstellt. Anschließend erstellt es den StreamWriter ersten Textschreiber, weist sie der Ausgabedatei zu und fügt sie der Listeners. Anschließend gibt der Code eine Textzeile in die Datei aus. Schließlich löscht das Beispiel den Ausgabepuffer.
Nach dem Ausführen dieses Beispiels können Sie die TestFile.txt Datei öffnen, 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;
}
}
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 Text writer abzurufen oder festzulegen, der die Ablaufverfolgungs- oder Debuggingausgabe empfängt.
Von Bedeutung
Dieser Typ implementiert die IDisposable Schnittstelle. Nach Abschluss der Verwendung sollten Sie den Typ entweder direkt oder indirekt löschen. Rufen Sie die Methode Dispose in einem try/catch-Block auf, um den Typ direkt zu entsorgen. Verwenden Sie zum indirekten Löschen ein Sprachkonstrukt wie using (in C#) oder Using (in Visual Basic). Weitere Informationen finden Sie im Abschnitt "Verwenden eines Objekts, das IDisposable implementiert" im IDisposable Schnittstellenthema.
Diese Klasse stellt außerdem Methoden bereit CloseWriter , sodass sie keine Ablaufverfolgungs- oder Debuggingausgabe mehr empfängt, an Flush den Ausgabepuffer für den Writer, und an Write eine Nachricht an die Writer.
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:DEBUGKennzeichnung 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=TrueFlag hinzu.Um die Ablaufverfolgung in C# zu aktivieren, fügen Sie die
/d:TRACEKennzeichnung 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=TrueFlag hinzu.
Um einen Ablaufverfolgungslistener in einer .NET Framework-App 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 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>
Hinweis
Wenn versucht wird, in eine Datei zu schreiben, die verwendet wird oder nicht verfügbar ist, wird der Dateiname automatisch einer GUID vorangestellt.
Konstruktoren
| Name | Beschreibung |
|---|---|
| TextWriterTraceListener() |
Initialisiert eine neue Instanz der TextWriterTraceListener Klasse als TextWriter Ausgabeempfänger. |
| TextWriterTraceListener(Stream, String) |
Initialisiert eine neue Instanz der TextWriterTraceListener Klasse mit dem angegebenen Namen, wobei der Datenstrom als Empfänger der Debug- und Ablaufverfolgungsausgabe verwendet wird. |
| TextWriterTraceListener(Stream) |
Initialisiert eine neue Instanz der TextWriterTraceListener Klasse, wobei der Datenstrom als Empfänger der Debug- und Ablaufverfolgungsausgabe verwendet wird. |
| TextWriterTraceListener(String, String) |
Initialisiert eine neue Instanz der TextWriterTraceListener Klasse mit dem angegebenen Namen, wobei die Datei als Empfänger der Debug- und Ablaufverfolgungsausgabe verwendet wird. |
| TextWriterTraceListener(String) |
Initialisiert eine neue Instanz der TextWriterTraceListener Klasse, wobei die Datei als Empfänger der Debug- und Ablaufverfolgungsausgabe verwendet wird. |
| TextWriterTraceListener(TextWriter, String) |
Initialisiert eine neue Instanz der TextWriterTraceListener Klasse mit dem angegebenen Namen, wobei der angegebene Writer als Empfänger der Ablaufverfolgungs- oder Debuggingausgabe verwendet wird. |
| TextWriterTraceListener(TextWriter) |
Initialisiert eine neue Instanz der Klasse mithilfe des TextWriterTraceListener angegebenen Writers als Empfänger der Ablaufverfolgungs- oder Debuggingausgabe. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Attributes |
Ruft die benutzerdefinierten Listenerattribute der Ablaufverfolgung ab, die in der Anwendungskonfigurationsdatei definiert sind. (Geerbt von TraceListener) |
| Filter |
Dient zum Abrufen oder Festlegen des Ablaufverfolgungsfilters für den Ablaufverfolgungslistener. (Geerbt von TraceListener) |
| IndentLevel |
Dient zum Abrufen oder Festlegen der Einzugsebene. (Geerbt von TraceListener) |
| IndentSize |
Dient zum Abrufen oder Festlegen der Anzahl von Leerzeichen in einem Einzug. (Geerbt von TraceListener) |
| IsThreadSafe |
Ruft einen Wert ab, der angibt, ob der Ablaufverfolgungslistener threadsicher ist. (Geerbt von TraceListener) |
| Name |
Dient zum Abrufen oder Festlegen eines Namens für dieses TraceListener. (Geerbt von TraceListener) |
| NeedIndent |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Ausgabe eingezogen werden soll. (Geerbt von TraceListener) |
| TraceOutputOptions |
Ruft die Ausgabeoptionen für die Ablaufverfolgung ab oder legt sie fest. (Geerbt von TraceListener) |
| Writer |
Ruft den Text writer ab, der die Ablaufverfolgungs- oder Debuggingausgabe empfängt, oder legt diesen fest. |
Methoden
| Name | Beschreibung |
|---|---|
| Close() |
Schließt die Schließung, Writer sodass sie 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() |
Veröffentlicht alle ressourcen, die von der TraceListener. (Geerbt von TraceListener) |
| Dispose(Boolean) |
Entfernt dieses TextWriterTraceListener Objekt. |
| 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. (Geerbt von TraceListener) |
| Fail(String) |
Gibt eine Fehlermeldung an den Listener aus, den Sie beim Implementieren der TraceListener Klasse erstellen. (Geerbt von TraceListener) |
| Flush() |
Löscht den Ausgabepuffer für die Writer. |
| 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. (Geerbt von TraceListener) |
| 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. (Geerbt von TraceListener) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Schreibt Ablaufverfolgungsinformationen, ein Array von Datenobjekten und Ereignisinformationen in die listenerspezifische Ausgabe. (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. (Geerbt von TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Schreibt Ablaufverfolgungsinformationen, eine Nachricht und Ereignisinformationen in die spezifische Ausgabe des Listeners. (Geerbt von TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Schreibt Ablaufverfolgungs- und Ereignisinformationen in die spezifische Ausgabe des Listeners. (Geerbt von TraceListener) |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
Schreibt Ablaufverfolgungsinformationen, eine Nachricht, eine zugehörige Aktivitätsidentität und Ereignisinformationen in die spezifische Ausgabe des Listeners. (Geerbt von TraceListener) |
| 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. (Geerbt von TraceListener) |
| Write(Object) |
Schreibt den Wert der Methode des Objekts ToString() in den Listener, den Sie beim Implementieren der TraceListener Klasse erstellen. (Geerbt von TraceListener) |
| Write(String, String) |
Schreibt einen Kategorienamen und eine Nachricht in den Listener, den Sie beim Implementieren der TraceListener Klasse erstellen. (Geerbt von TraceListener) |
| Write(String) |
Schreibt eine Nachricht in die Instanzen Writer. |
| WriteIndent() |
Schreibt den Einzug in den Listener, den Sie beim Implementieren dieser Klasse erstellen, und setzt die NeedIndent Eigenschaft auf |
| 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. (Geerbt von TraceListener) |
| 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. (Geerbt von TraceListener) |
| WriteLine(String, String) |
Schreibt einen Kategorienamen und eine Nachricht in den Listener, den Sie beim Implementieren der TraceListener Klasse erstellen, gefolgt von einem Zeilenterminator. (Geerbt von TraceListener) |
| WriteLine(String) |
Schreibt eine Nachricht in die Writer Instanz gefolgt von einem Zeilenterminator. Der Standardzeilenabschluss ist eine Wagenrücklauf, gefolgt von einem Zeilenvorschub (\r\n). |
