StreamWriter.Close 方法

定義

關閉目前的 StreamWriter 物件和基礎資料流。

public:
 override void Close();
public override void Close ();
override this.Close : unit -> unit
Public Overrides Sub Close ()

例外狀況

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

範例

下列程式碼範例示範 Close 方法。

// close the file by closing the writer
sw->Close();
// close the file by closing the writer
sw.Close();
' Close the file by closing the writer.
Sw.Close()

備註

這個方法會覆寫 Stream.Close

這個 實作會 Close 呼叫 Dispose 傳遞 true 值的方法。

您必須呼叫 Close 以確保所有資料都正確寫出至基礎資料流程。 在 呼叫 Close 之後,上 StreamWriter 的任何作業可能會引發例外狀況。 如果磁碟空間不足,呼叫 Close 將會引發例外狀況。

除非您明確呼叫 FlushClose ,否則清除資料流程不會排清其基礎編碼器。 設定 AutoFlushtrue 表示資料會從緩衝區排清到資料流程,但不會清除編碼器狀態。 這可讓編碼器保持其狀態 (部分字元) ,以便正確編碼下一個字元區塊。 此案例會影響 UTF8 和 UTF7,其中某些字元只能在編碼器收到相鄰字元或字元之後進行編碼。

適用於

另請參閱