StreamWriter.Close Metodo

Definizione

Chiude l'oggetto StreamWriter corrente e il flusso sottostante.

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

Eccezioni

La codifica corrente non supporta la visualizzazione della metà di una coppia di surrogati Unicode.

Esempio

Nell'esempio di codice seguente viene illustrato il Close metodo .

// 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()

Commenti

Questo metodo esegue l'override di Stream.Close.

Questa implementazione di Close chiama il Dispose metodo passando un true valore.

È necessario chiamare Close per assicurarsi che tutti i dati vengano scritti correttamente nel flusso sottostante. Dopo una chiamata a Close, qualsiasi operazione su StreamWriter potrebbe generare eccezioni. Se lo spazio sul disco non è sufficiente, la chiamata Close genererà un'eccezione.

Lo scaricamento del flusso non scarica il codificatore sottostante, a meno che non si chiami Flush in modo esplicito o Close. Se si imposta AutoFlush su true , i dati verranno scaricati dal buffer al flusso, ma lo stato del codificatore non verrà scaricato. In questo modo il codificatore può mantenere lo stato (caratteri parziali) in modo che possa codificare correttamente il blocco successivo di caratteri. Questo scenario influisce su UTF8 e UTF7 in cui determinati caratteri possono essere codificati solo dopo che il codificatore riceve il carattere o i caratteri adiacenti.

Si applica a

Vedi anche