StreamWriter.AutoFlush Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define um valor que indica se o StreamWriter irá esvaziar o seu buffer para o fluxo subjacente após cada chamada para Write(Char).
public:
virtual property bool AutoFlush { bool get(); void set(bool value); };public virtual bool AutoFlush { get; set; }member this.AutoFlush : bool with get, setPublic Overridable Property AutoFlush As BooleanValor de Propriedade
true para forçar StreamWriter a lavagem do seu buffer; caso contrário, false.
Exemplos
O exemplo seguinte mostra a sintaxe para usar a AutoFlush propriedade.
// Gets or sets a value indicating whether the StreamWriter
// will flush its buffer to the underlying stream after every
// call to StreamWriter.Write.
sw.AutoFlush = true;
' Gets or sets a value indicating whether the StreamWriter
' will flush its buffer to the underlying stream after every
' call to StreamWriter.Write.
Sw.AutoFlush = True
Observações
Limpar o fluxo não irá limpar o seu codificador subjacente a menos que chame Flush explicitamente ou Close. Definir AutoFlush para true significa que os dados serão esvaziados do buffer para o fluxo após cada operação de escrita, mas o estado do codificador não será esvaziado. Isto permite ao codificador manter o seu estado (caracteres parciais) para que possa codificar corretamente o próximo bloco de caracteres. Este cenário afeta UTF8 e UTF7, onde certos caracteres só podem ser codificados depois de o codificador receber o(s) carácter adjacente(s).
Quando AutoFlush está definido para false, StreamWriter fará uma quantidade limitada de buffering, tanto internamente como potencialmente no codificador da codificação que passou. Pode obter melhor desempenho definindo AutoFlush para false, assumindo que sempre chama Close (ou pelo Flushmenos ) quando termina de escrever com um StreamWriter.
Por exemplo, defina AutoFlush para true quando está a escrever num dispositivo onde o utilizador espera feedback imediato.
Console.Out é um destes casos: O StreamWriter usado internamente para escrever para Console limpa todo o seu estado interno, exceto o estado do codificador, após cada chamada para StreamWriter.Write.
Para uma lista de tarefas comuns de E/S, consulte Tarefas Comuns de E/S.
