StreamWriter.AutoFlush Propriedade

Definição

Obtém ou define um valor que indica se o StreamWriter liberará o buffer para o fluxo subjacente após toda a 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, set
Public Overridable Property AutoFlush As Boolean

Valor da propriedade

Boolean

true para forçar o StreamWriter a liberar o buffer; caso contrário, false.

Exemplos

O exemplo a seguir 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;
' 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

Comentários

A liberação do fluxo não liberará seu codificador subjacente, a menos que você chame explicitamente Flush ou Close . Definir como 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 AutoFlush true 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.

Quando for definido como , o fará uma quantidade limitada de buffer, tanto internamente quanto potencialmente no codificador da codificação que AutoFlush false você StreamWriter passou. Você pode obter um melhor desempenho definindo como , supondo que sempre chame (ou pelo menos ) quando terminar de AutoFlush false escrever com um Close Flush StreamWriter .

Por exemplo, de AutoFlush definido como quando você estiver escrevendo em um dispositivo em que o usuário espera comentários true imediatos. Console.Out é um desses casos: o usado internamente para a escrita para libera todo o seu estado interno, exceto o estado do codificador após StreamWriter Console cada chamada para StreamWriter.Write .

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

Aplica-se a

Confira também