StreamWriter.AutoFlush 屬性

  • 參考

定義

命名空間:
System.IO
組件:
System.IO.dll
組件:
System.Runtime.dll
組件:
System.Runtime.Extensions.dll
組件:
mscorlib.dll
組件:
netstandard.dll
來源:
StreamWriter.cs
來源:
StreamWriter.cs
來源:
StreamWriter.cs

取得或設定值，指出 StreamWriter 在每次呼叫 Write(Char) 之後，是否要將其緩衝區清除到基礎資料流。

public:
 virtual property bool AutoFlush { bool get(); void set(bool value); };
public virtual bool AutoFlush { get; set; }
member this.AutoFlush : bool with get, set
Public Overridable Property AutoFlush As Boolean

屬性值

Boolean

強制 StreamWriter 清除其緩衝區，則為 true，否則為 false。

範例

下列範例顯示使用 屬性的 AutoFlush 語法。

// Gets or sets a value indicating whether the StreamWriter
// will flush its buffer to the underlying stream after every 
// call to StreamWriter.Write.
sw->AutoFlush = true;

// Gets or sets a value indicating whether the StreamWriter
// will flush its buffer to the underlying stream after every
// call to StreamWriter.Write.
sw.AutoFlush = true;

' Gets or sets a value indicating whether the StreamWriter
' will flush its buffer to the underlying stream after every 
' call to StreamWriter.Write.
Sw.AutoFlush = True

備註

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

當 設定為 false時AutoFlush，StreamWriter將會從您傳入的編碼，在內部和可能在編碼器中執行有限的緩衝處理。 您可以藉由將 設定AutoFlush為 false來取得更好的效能，假設您在完成撰寫 StreamWriter時一律呼叫 Close (或至少 Flush) 。

例如，當您寫入使用者預期立即意見反應的裝置時，請將 設定AutoFlushtrue為 。 Console.Out 是下列其中一種情況：用於 StreamWriter 寫入以 Console 排清其所有內部狀態，但每次呼叫 StreamWriter.Write之後的編碼器狀態除外。

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

適用於

另請參閱