語言

StreamWriter.Close 方法

定義

關閉目前 StreamWriter 的物件和底層的串流。

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

例外狀況

目前的編碼不支援顯示 Unicode 代理對的一半。

範例

以下程式碼範例示範了此 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 會觸發例外。

除非你明確呼叫 Flush 或 Close,否則 flush 串流不會沖走其底層編碼器。 設定 AutoFlush 為 true 表示資料會從緩衝區沖洗到串流,但編碼器狀態不會被沖洗。 這讓編碼器能保留其狀態(部分字元),以便正確編碼下一個字元區塊。 此情境影響 UTF8 與 UTF7,因為某些字元只能在編碼器接收相鄰字元後再編碼。

適用於

另請參閱