StreamWriter.Close 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
關閉目前的 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 將會引發例外狀況。
除非您明確呼叫 Flush 或 Close ,否則清除資料流程不會排清其基礎編碼器。 設定 AutoFlush 為 true
表示資料會從緩衝區排清到資料流程,但不會清除編碼器狀態。 這可讓編碼器保持其狀態 (部分字元) ,以便正確編碼下一個字元區塊。 此案例會影響 UTF8 和 UTF7,其中某些字元只能在編碼器收到相鄰字元或字元之後進行編碼。
適用於
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將推出:在 2024 年,我們將隨著內容的意見反應機制逐步淘汰 GitHub 問題,並以新的意見反應系統來取代。 如需詳細資訊,請參閱提交並檢視相關的意見反應