Trace.Close Methode
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.
Löscht den Ausgabepuffer und schließt dann den Listeners.
public:
static void Close();[System.Diagnostics.Conditional("TRACE")]
public static void Close();[<System.Diagnostics.Conditional("TRACE")>]
static member Close : unit -> unitPublic Shared Sub Close ()- Attribute
Beispiele
Im folgenden Beispiel wird ein benannter TextWriterTraceListener Name myTextListenererstellt.
myTextListener verwendet einen StreamWriter Aufruf myOutputWriter zum Schreiben in eine Datei mit dem Namen TestFile.txt. Im Beispiel wird die Datei, der Datenstrom und der Textschreiber erstellt, eine Textzeile in die Datei geschrieben, anschließend wird die Ausgabe geleert und geschlossen.
// Specify /d:TRACE when compiling.
using System;
using System.IO;
using System.Diagnostics;
class Test
{
static void Main()
{
// Create a file for output named TestFile.txt.
using (FileStream myFileStream =
new FileStream("TestFile.txt", FileMode.Append))
{
// Create a new text writer using the output stream
// and add it to the trace listeners.
TextWriterTraceListener myTextListener =
new TextWriterTraceListener(myFileStream);
Trace.Listeners.Add(myTextListener);
// Write output to the file.
Trace.WriteLine("Test output");
// Flush and close the output stream.
Trace.Flush();
Trace.Close();
}
}
}
' Specify /d:TRACE=True when compiling.
Imports System.IO
Imports System.Diagnostics
Class Test
Shared Sub Main()
' Create a file for output named TestFile.txt.
Using myFileStream As New FileStream("TestFile.txt", FileMode.Append)
' Create a new text writer using the output stream
' and add it to the trace listeners.
Dim myTextListener As New TextWriterTraceListener(myFileStream)
Trace.Listeners.Add(myTextListener)
' Write output to the file.
Trace.WriteLine("Test output")
' Flush and close the output stream.
Trace.Flush()
Trace.Close()
End Using
End Sub
End Class
Hinweise
Verwenden Sie diese Methode, wenn die Ausgabe zu einer Datei wird, z. B. an die TextWriterTraceListenerDatei.
Durch das Leeren des Datenstroms wird der zugrunde liegende Encoder nicht geleert, es sei denn, Sie rufen Flush explizit auf oder Close. Die Einstellung AutoFlush bedeutet true , dass Daten aus dem Puffer in den Datenstrom geleert werden, der Encoderstatus wird jedoch nicht geleert. Dadurch kann der Encoder seinen Zustand (Teilzeichen) beibehalten, damit er den nächsten Zeichenblock richtig codieren kann. Dieses Szenario wirkt sich auf UTF8 und UTF7 aus, bei dem bestimmte Zeichen nur codiert werden können, nachdem der Encoder das angrenzende Zeichen oder zeichen empfängt.
