Stream.Flush Метод

Определение

При переопределении в производном классе очищает все буферы данного потока и вызывает запись данных буферов в базовое устройство.When overridden in a derived class, clears all buffers for this stream and causes any buffered data to be written to the underlying device.

public:
 abstract void Flush();
public abstract void Flush ();
abstract member Flush : unit -> unit
Public MustOverride Sub Flush ()

Исключения

Ошибка ввода-вывода.An I/O error occurs.

Комментарии

Переопределение Flush для потоков, реализующих буфер.Override Flush on streams that implement a buffer. Этот метод используется для перемещения любых данных из базового буфера в место назначения, очистки буфера или и того и другого.Use this method to move any information from an underlying buffer to its destination, clear the buffer, or both. В зависимости от состояния объекта может потребоваться изменить текущую точку в потоке (например, если базовый поток поддерживает поиск).Depending upon the state of the object, you might have to modify the current position within the stream (for example, if the underlying stream supports seeking). Дополнительные сведения см. в разделе CanSeek.For additional information see CanSeek.

В классе, производном от Stream, который не поддерживает запись, Flush обычно реализуется как пустой метод для обеспечения полной совместимости с другими типами Stream, так как он является допустимым для очистки потока, доступного только для чтения.In a class derived from Stream that doesn't support writing, Flush is typically implemented as an empty method to ensure full compatibility with other Stream types since it's valid to flush a read-only stream.

При использовании класса StreamWriter или BinaryWriter не следует сбрасывать базовый объект Stream.When using the StreamWriter or BinaryWriter class, do not flush the base Stream object. Вместо этого используйте метод Flush или Close класса, который гарантирует, что данные сбрасываются в базовый поток, а затем записываются в файл.Instead, use the class's Flush or Close method, which makes sure that the data is flushed to the underlying stream first and then written to the file.

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

Дополнительно