StreamWriter.Close Metod

Definition

Stänger det aktuella StreamWriter objektet och den underliggande strömmen.

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

Undantag

Den aktuella kodningen stöder inte att hälften av ett Unicode-surrogatpar visas.

Exempel

I följande kodexempel visas Close metoden.

// close the file by closing the writer
sw.Close();
' Close the file by closing the writer.
Sw.Close()

Kommentarer

Den här metoden åsidosätter Stream.Close.

Den här implementeringen av Close anropar metoden som Dispose skickar ett true värde.

Du måste anropa Close för att säkerställa att alla data skrivs ut korrekt till den underliggande dataströmmen. Efter ett anrop till Closekan alla åtgärder på undantagen StreamWriter genereras. Om det inte finns tillräckligt med utrymme på disken skapar anrop Close ett undantag.

Om dataströmmen töms töms inte dess underliggande kodare om du inte uttryckligen anropar Flush eller Close. true Inställningen AutoFlush innebär att data rensas från bufferten till strömmen, men kodartillståndet rensas inte. Detta gör att kodaren kan behålla sitt tillstånd (partiella tecken) så att nästa teckenblock kan kodas korrekt. Det här scenariot påverkar UTF8 och UTF7 där vissa tecken bara kan kodas efter att kodaren har fått det intilliggande tecknet eller tecknen.

Gäller för

Se även