Trace.Flush-Methode

Entleert den Ausgabepuffer und veranlasst das Schreiben der gepufferten Daten in die Listeners.

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

Syntax

'Declaration
<ConditionalAttribute("TRACE")> _
Public Shared Sub Flush
'Usage

Trace.Flush

[ConditionalAttribute("TRACE")] 
public static void Flush ()

[ConditionalAttribute(L"TRACE")] 
public:
static void Flush ()

/** @attribute ConditionalAttribute("TRACE") */ 
public static void Flush ()

ConditionalAttribute("TRACE") 
public static function Flush ()

Hinweise

Durch Entleeren des Streams wird der zugrunde liegende Encoder nicht entleert, wenn Sie nicht ausdrücklich Flush oder Close aufrufen. Wenn AutoFlush auf true festgelegt ist, werden Daten aus dem Puffer in den Stream entleert, aber der Encoderzustand wird nicht geleert. Dadurch kann der Encoder seinen Zustand beibehalten (Teilzeichen), um den nächsten Block von Zeichen richtig zu codieren. Dieses Szenario betrifft UTF8 und UTF7, bei denen bestimmte Zeichen nur verschlüsselt werden können, nachdem der Encoder das bzw. die angrenzenden Zeichen empfangen hat.

Beispiel

Im folgenden Beispiel wird ein TextWriterTraceListener mit der Bezeichnung myTextListener erstellt. myTextListener verwendet einen StreamWriter mit der Bezeichnung myOutputWriter, um in eine Datei mit dem Namen TestFile.txt zu schreiben. Im Beispiel werden die Datei, ein Stream und ein Textwriter erstellt, eine Textzeile in die Datei geschrieben und dann die Ausgabe entleert und geschlossen.

Public Shared Sub Main()
    ' Create a file for output named TestFile.txt.
    Dim myFileName As String = "TestFile.txt"
    If Not File.Exists(myFileName) Then
        Dim myFile As Stream = File.Create(myFileName)
        
        ' Assign output file to output stream.
        Dim myOutputWriter As StreamWriter
        myOutputWriter = File.AppendText(myFileName)
        
        ' Create a new text writer using the output stream, and 
        ' add it to the trace listeners. 
        Dim myTextListener As New TextWriterTraceListener(myOutputWriter)
        Trace.Listeners.Add(myTextListener)
        
        ' Write output to the file.
        Trace.WriteLine("Test output")
        
        ' Flush and close the output stream.
        Trace.Flush()
        Trace.Close()
    End If
End Sub

public static void Main(string[] args) {
    // Create a file for output named TestFile.txt.
    String myFileName = "TestFile.txt";
    if(!File.Exists(myFileName))
    {
       Stream myFile = File.Create(myFileName);
 
    // Assign output file to output stream.
    StreamWriter myOutputWriter;
    myOutputWriter = File.AppendText(myFileName);
 
    /* Create a new text writer using the output stream, and 
     * add it to the trace listeners. */
    TextWriterTraceListener myTextListener = new 
       TextWriterTraceListener(myOutputWriter);
    Trace.Listeners.Add(myTextListener);
 
    // Write output to the file.
    Trace.WriteLine("Test output");
 
    // Flush and close the output stream.
    Trace.Flush();
    Trace.Close();
   }
 }
 

int main()
{
   
   // Create a file for output named TestFile.txt.
   String^ myFileName = "TestFile.txt";
   if (  !File::Exists( myFileName ) )
   {
      Stream^ myFile = File::Create( myFileName );
      
      // Assign output file to output stream.
      StreamWriter^ myOutputWriter;
      myOutputWriter = File::AppendText( myFileName );
      
      /* Create a new text writer using the output stream, and 
            * add it to the trace listeners. */
      TextWriterTraceListener^ myTextListener = gcnew TextWriterTraceListener( myOutputWriter );
      Trace::Listeners->Add( myTextListener );
      
      // Write output to the file.
      Trace::WriteLine( "Test output" );
      
      // Flush and close the output stream.
      Trace::Flush();
      Trace::Close();
   }
}

public static void main(String[] args)
{
    // Create a file for output named TestFile.txt.
    String myFileName = "TestFile.txt";
    if (!(File.Exists(myFileName))) {
        Stream myFile = File.Create(myFileName);

        // Assign output file to output stream.
        StreamWriter myOutputWriter;
        myOutputWriter = File.AppendText(myFileName);

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

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

        // Flush and close the output stream.
        Trace.Flush();
        Trace.Close();
    }
} //main

// Open or create a file stream for output named TestFile.txt.
var myOutputWriter : FileStream = File.OpenWrite("TestFile.txt")

// Specify myOutputWriter as the Trace output stream by
// adding it to the trace listeners. 
Trace.Listeners.Add(new TextWriterTraceListener(myOutputWriter))

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

// Flush and close the output stream.
Trace.Flush()
Trace.Close()

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Trace-Klasse
Trace-Member
System.Diagnostics-Namespace
Debug-Klasse
Trace-Klasse
BooleanSwitch-Klasse
TraceSwitch
TraceListener
DefaultTraceListener-Klasse
ConditionalAttribute-Klasse