Stream.DisposeAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Асинхронно освобождает неуправляемые ресурсы, используемые Streamв .
public:
virtual System::Threading::Tasks::ValueTask DisposeAsync();public virtual System.Threading.Tasks.ValueTask DisposeAsync();abstract member DisposeAsync : unit -> System.Threading.Tasks.ValueTask
override this.DisposeAsync : unit -> System.Threading.Tasks.ValueTaskPublic Overridable Function DisposeAsync () As ValueTaskВозвращаемое значение
Задача, представляющая асинхронную операцию удаления.
Реализации
Комментарии
Этот DisposeAsync метод позволяет выполнять ресурсоемкую операцию удаления без блокировки основного потока. Это особенно важно в приложении для Магазина Windows 8.x или классическом приложении, где времязатратная операция потока может заблокировать поток пользовательского интерфейса и создать впечатление, что приложение не работает. Асинхронные методы используются в сочетании с asyncawait ключевыми словами в Visual Basic и C#.
Этот метод удаляет поток, записывая любые изменения в резервное хранилище и закрывая поток для освобождения ресурсов.
Вызов DisposeAsync позволяет ресурсам, используемым Stream перераспределенными для других целей. Дополнительные сведения см. в разделе "Очистка неуправляемых ресурсов".
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Dispose().