StreamWriter.AutoFlush Свойство

Определение

Получает или задает значение, определяющее, будет ли StreamWriter сбрасывать буфер в основной поток после каждого вызова 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

Значение свойства

Boolean

Значение true, чтобы заставить StreamWriter сбросить буфер; в противном случае — false.

Примеры

В следующем примере показан синтаксис для использования AutoFlush Свойства.

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

Комментарии

При сбросе потока его базовый кодировщик не очищается, пока не будет явно вызван метод Flush или Close . Если задано значение AutoFlush true , то данные будут сброшены из буфера в поток после каждой операции записи, но состояние кодировщика не будет сбрасываться. Это позволяет кодировщику оставаться в состоянии (частичные символы), чтобы он мог правильно кодировать следующий блок символов. Этот сценарий влияет на UTF8 и UTF7, где определенные символы могут быть закодированы только после того, как кодировщик получит смежный символ или символы.

Если параметр AutoFlush имеет значение false , StreamWriter будет выполнять ограниченный объем буферизации, как внутри, так и потенциально в кодировщике, из переданной Вами кодировки. Можно повысить производительность, задав для значение AutoFlush false , предполагая, что при Close завершении записи с помощью всегда вызывается (или по крайней мере Flush ) StreamWriter .

Например, задайте значение AutoFlush true при записи на устройство, на котором пользователь ожидает немедленной отзыв. Console.Out в одном из следующих случаев: StreamWriter используется для внутренних целей записи, чтобы Console Очистить все внутреннее состояние, за исключением состояния кодировщика, после каждого вызова StreamWriter.Write .

Список общих задач ввода-вывода см. в разделе Общие задачи ввода-вывода.

Применяется к

См. также раздел