StreamWriter.Close Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.