Debug.Flush-Methode

Leert den Ausgabepuffer und veranlasst das Schreiben der gepufferten Daten in die Listeners-Auflistung.

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

Syntax

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

Debug.Flush

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

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

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

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

Hinweise

Durch Leeren des Streams wird der zugrunde liegende Encoder nicht geleert, sofern Sie nicht explizit Flush oder Close aufrufen. Wenn AutoFlush auf true festgelegt ist, werden Daten aus dem Puffer in den Stream weggeschrieben, aber der Encoderzustand wird nicht geleert. Dadurch kann der Encoder seinen Zustand beibehalten (Teilzeichen), um den nächsten Zeichenblock richtig zu codieren. Dieses Szenario betrifft UTF8 und UTF7, wo 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 geleert und geschlossen.

Overloads  Shared Sub Main(args() As String)
    ' Create a file for output named TestFile.txt.
    Dim myFileName As String = "TestFile.txt"
    If Not File.Exists(myFileName) Then
        File.Create(myFileName)
    End If 
    
    ' 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)
    Debug.Listeners.Add(myTextListener)
    
    ' Write output to the file.
    Debug.WriteLine("Test output")
    
    ' Flush and close the output stream.
    Debug.Flush()
    Debug.Close()
End Sub 'Main

static void Main(string[] args) {
    // Create a file for output named TestFile.txt.
    String myFileName = "TestFile.txt";
    if(!File.Exists(myFileName)) 
    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);
    Debug.Listeners.Add(myTextListener);
  
    // Write output to the file.
    Debug.WriteLine("Test output");
 
    // Flush and close the output stream.
    Debug.Flush();
    Debug.Close();
 }

#using <System.dll>

using namespace System;
using namespace System::IO;
using namespace System::Diagnostics;
int main( void )
{
   
   // Create a file for output named TestFile.txt.
   String^ myFileName = "TestFile.txt";
   if (  !File::Exists( myFileName ) )
      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 );
   Debug::Listeners->Add( myTextListener );
   
   // Write output to the file.
   Debug::WriteLine( "Test output" );
   
   // Flush and close the output stream.
   Debug::Flush();
   Debug::Close();
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, 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

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

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