StreamWriter.Flush Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Origem:

StreamWriter.cs

Limpa todos os buffers para o gravador atual e faz com que todos os dados armazenados em buffer sejam gravados no fluxo subjacente.

public:
 override void Flush();

public override void Flush ();

override this.Flush : unit -> unit

Public Overrides Sub Flush ()

Exceções

ObjectDisposedException

O gravador atual está fechado.

IOException

Ocorreu um erro de E/S.

EncoderFallbackException

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

Comentários

Este método substitui TextWriter.Flush.

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 após cada operação de gravação, 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.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

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