Stream.FlushAsync Метод

Определение

Пространство имен:

System.IO

Сборки:

netstandard.dll, System.Runtime.dll

Асинхронно очищает все буферы для этого потока и приводит к записи всех буферных данных на базовое устройство.

Перегрузки

Имя	Описание
FlushAsync()	Асинхронно очищает все буферы для этого потока и приводит к записи всех буферных данных на базовое устройство.
FlushAsync(CancellationToken)	Асинхронно очищает все буферы для этого потока, приводит к записи всех буферных данных на базовое устройство и отслеживает запросы на отмену.

FlushAsync()

Исходный код:

Stream.cs

Асинхронно очищает все буферы для этого потока и приводит к записи всех буферных данных на базовое устройство.

public:
 System::Threading::Tasks::Task ^ FlushAsync();

public System.Threading.Tasks.Task FlushAsync();

member this.FlushAsync : unit -> System.Threading.Tasks.Task

Public Function FlushAsync () As Task

Возвращаемое значение

Task

Задача, представляющая асинхронную операцию очистки.

Исключения

ObjectDisposedException

Поток удален.

Комментарии

Если производный класс, например DeflateStream или GZipStream, не очищает буфер в реализации Flush метода, FlushAsync метод не будет очищать буфер.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Flush().

FlushAsync(CancellationToken)

Исходный код:

Stream.cs

Асинхронно очищает все буферы для этого потока, приводит к записи всех буферных данных на базовое устройство и отслеживает запросы на отмену.

public:
 virtual System::Threading::Tasks::Task ^ FlushAsync(System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.Task FlushAsync(System.Threading.CancellationToken cancellationToken);

abstract member FlushAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.FlushAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function FlushAsync (cancellationToken As CancellationToken) As Task

Параметры

cancellationToken

CancellationToken

Маркер для отслеживания запросов на отмену. Значение по умолчанию — None.

Возвращаемое значение

Task

Задача, представляющая асинхронную операцию очистки.

Исключения

ObjectDisposedException

Поток удален.

OperationCanceledException

Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.

Комментарии

Если операция отменена до завершения, возвращаемая задача содержит Canceled значение свойства Status .

Если производный класс, например DeflateStream или GZipStream, не очищает буфер в реализации Flush метода, FlushAsync метод не будет очищать буфер.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Flush().

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

• Отмена