StreamWriter.Close 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
關閉目前 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,因為某些字元只能在編碼器接收相鄰字元後再編碼。