StreamWriter.Close Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Origem:

StreamWriter.cs

Fecha o atual objeto StreamWriter e o fluxo subjacente.

public:
 override void Close();

public override void Close ();

override this.Close : unit -> unit

Public Overrides Sub Close ()

Exceções

EncoderFallbackException

A codificação atual não dá suporte à exibição de metade de um par alternativo Unicode.

Exemplos

O exemplo de código a seguir demonstra o Close método .

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

Comentários

Este método substitui Stream.Close.

Essa implementação de Close chama o Dispose método passando um true valor.

Você deve chamar Close para garantir que todos os dados sejam gravados corretamente no fluxo subjacente. Após uma chamada para Close, todas as operações no StreamWriter podem gerar exceções. Se não houver espaço suficiente no disco, chamar Close gerará uma exceção.

A liberação do fluxo não liberará seu codificador subjacente, a menos que você chame Flush explicitamente ou Close. Definir AutoFlush como true significa que os dados serão liberados do buffer para o fluxo, mas o estado do codificador não será liberado. Isso permite que o codificador mantenha seu estado (caracteres parciais) para que ele possa codificar o próximo bloco de caracteres corretamente. Esse cenário afeta UTF8 e UTF7, em que determinados caracteres só podem ser codificados depois que o codificador recebe o caractere ou caracteres adjacentes.

Confira também

• E/S de arquivo e de fluxo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo