FileStream.FlushAsync(CancellationToken) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Асинхронно очищает все буферы для этого потока, приводит к записи буферных данных в файл и отслеживает запросы на отмену.
public:
override System::Threading::Tasks::Task ^ FlushAsync(System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task FlushAsync(System.Threading.CancellationToken cancellationToken);[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task FlushAsync(System.Threading.CancellationToken cancellationToken);override this.FlushAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task[<System.Runtime.InteropServices.ComVisible(false)>]
override this.FlushAsync : System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overrides Function FlushAsync (cancellationToken As CancellationToken) As TaskПараметры
- cancellationToken
- CancellationToken
Маркер для отслеживания запросов на отмену.
Возвращаемое значение
Задача, представляющая асинхронную операцию очистки.
- Атрибуты
Исключения
Поток удален.
Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.
Комментарии
Этот метод сбрасывает буферы потоков .NET в файл, но не сбрасывает промежуточные буферы файлов в операционной системе. Чтобы убедиться, что все буферные данные записываются на базовое устройство хранилища, используйте Flush(Boolean) метод с заданным параметром flushToDisktrue.
Если операция отменена до завершения, возвращаемая задача содержит Canceled значение свойства Status . Если дескриптор файла удален, возвращаемая задача содержит ObjectDisposedException исключение в свойстве Exception .
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Flush().
