StreamWriter.Close Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Zdroj:

StreamWriter.cs

Zavře aktuální StreamWriter objekt a podkladový datový proud.

public:
 override void Close();

public override void Close ();

override this.Close : unit -> unit

Public Overrides Sub Close ()

Výjimky

EncoderFallbackException

Aktuální kódování nepodporuje zobrazení poloviny náhradního páru Unicode.

Příklady

Následující příklad kódu ukazuje metodu 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()

Poznámky

Tato metoda přepíše Stream.Close.

Tato implementace Close volá metodu Dispose předávání true hodnoty.

Je nutné volat Close , abyste zajistili, že jsou všechna data správně zapsána do podkladového datového proudu. Po volání Closemůžou všechny operace v nástroji StreamWriter vyvolat výjimky. Pokud není na disku dostatek místa, vyvolá volání Close výjimku.

Vyprázdnění datového proudu nevyprázdní jeho základní kodér, pokud explicitně nevoláte Flush nebo Close. Nastavení AutoFlush na znamená true , že data budou vyprázdněna z vyrovnávací paměti do datového proudu, ale stav kodéru se nevyprázdní. To umožňuje kodéru zachovat svůj stav (částečné znaky), aby mohl správně zakódovat další blok znaků. Tento scénář má vliv na UTF8 a UTF7, kde určité znaky lze zakódovat pouze poté, co kodér přijme sousední znak nebo znaky.

Viz také

• Vstupně-výstupní operace souborů a Stream
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru