StreamWriter.AutoFlush 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得或設定值，指出 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, setPublic Overridable Property AutoFlush As 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 工作。
