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の実装では、true値を渡すDispose メソッドが呼び出されます。
すべてのデータが基になるストリームに正しく書き込まれるように、 Close を呼び出す必要があります。 Closeの呼び出しの後、StreamWriterに対するすべての操作で例外が発生する可能性があります。 ディスクに十分な領域がない場合、 Close を呼び出すと例外が発生します。
明示的に Flush または Closeを呼び出さない限り、ストリームをフラッシュしても、基になるエンコーダーはフラッシュされません。
AutoFlushを true に設定すると、データはバッファーからストリームにフラッシュされますが、エンコーダーの状態はフラッシュされません。 これにより、エンコーダーは状態 (部分的な文字) を保持して、次の文字ブロックを正しくエンコードできます。 このシナリオは UTF8 と UTF7 に影響を与え、エンコーダーが隣接する文字を受信した後でのみ特定の文字をエンコードできます。