Debug.Flush メソッド

.NET Framework クラス ライブラリ リファレンス

Debug.Flush メソッド

出力バッファをフラッシュし、バッファ内のデータを Listeners コレクションに書き込みます。

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Debug.Flush

C#

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

C++

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

J#

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

JScript

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

解説

ストリームをフラッシュしても、Flush または Close を明示的に呼び出さない限り、そのストリームの基になるエンコーダはフラッシュされません。AutoFlush を true に設定すると、データがバッファからストリームにフラッシュされますが、エンコーダの状態はフラッシュされません。これにより、エンコーダの状態 (一部の文字) を維持できるため、次のブロックの文字を正確にエンコードできるようになります。この動作は、一部の文字をエンコードするためにはエンコーダがあらかじめその文字に隣接する文字を受け取っておく必要がある UTF8 および UTF7 に対して有効です。

使用例

myTextListener という名前の TextWriterTraceListener を作成する例を次に示します。myTextListener は、myOutputWriter という名前の StreamWriter を使用して、TestFile.txt というファイルに書き込みます。この例では、ファイル、ストリーム、およびテキスト ライタを作成し、テキストの 1 行をファイルに書き込んでから、出力をフラッシュして終了します。

Visual Basic

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

C#

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();
 }

C++

#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();
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Debug クラス
Debug メンバ
System.Diagnostics 名前空間
Debug クラス
Trace
BooleanSwitch クラス
TraceSwitch
TraceListener
DefaultTraceListener
ConsoleTraceListener クラス
ConditionalAttribute クラス