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, setPublic Overridable Property AutoFlush As 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
Комментарии
Очистка потока не будет очищать его базовый кодировщик, если вы явно не вызовете Flush или Close.
AutoFlush Значение параметра true означает, что данные будут удалены из буфера в поток после каждой операции записи, но состояние кодировщика не будет удалено. Это позволяет кодировщику сохранять состояние (частичные символы), чтобы кодировать следующий блок символов правильно. Этот сценарий влияет на UTF8 и UTF7, где некоторые символы могут быть закодированы только после того, как кодировщик получает смежные символы или символы.
Если AutoFlush задано falseзначение , StreamWriter будет выполняться ограниченный объем буферизации, как внутренне, так и потенциально в кодировщике из передаваемой кодировки. Вы можете повысить производительность, установив значение AutoFlushfalse, при условии, что вы всегда вызываете Close (или по крайней мереFlush) при выполнении записи с помощью .StreamWriter
Например, задайте значение AutoFlushtrue при записи на устройство, в котором пользователь ожидает немедленного отзыва.
Console.Out является одним из этих случаев: StreamWriter используется внутренне для записи для очистки Console всего внутреннего состояния, кроме состояния кодировщика после каждого вызова StreamWriter.Write.
Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.
