Trace.Flush メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

Trace.Flush メソッド

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Trace.Flush

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

C++

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

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

JScript

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

解説

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

使用例

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

Visual Basic

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

C++

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

JScript

// 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()