StreamWriter.Flush 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

來源:

StreamWriter.cs

清除目前寫入器 (Writer) 的所有緩衝區，並且造成所有緩衝資料都寫入基礎資料流。

public:
 override void Flush();

public override void Flush ();

override this.Flush : unit -> unit

Public Overrides Sub Flush ()

例外狀況

ObjectDisposedException

目前寫入器已關閉。

IOException

發生 I/O 錯誤。

EncoderFallbackException

目前的編碼不支援顯示 Unicode Surrogate 字組的其中一半。

備註

這個方法會覆寫 TextWriter.Flush。

除非您明確呼叫 Flush 或 Close，否則清除數據流不會排清其基礎編碼器。 設定 AutoFlush 為 true 表示數據會在每次寫入作業之後從緩衝區排清到數據流，但不會排清編碼器狀態。 這可讓編碼器保持其狀態 (部分字元) ，以便正確編碼下一個字元區塊。 此案例會影響UTF8和UTF7，其中某些字元只能在編碼器收到相鄰字元或字元之後進行編碼。

如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

另請參閱

• Close()
• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案