Stream.DisposeAsync Метод

Определение

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

System.IO

Сборка:

System.Runtime.dll

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

Stream.cs

Асинхронно освобождает неуправляемые ресурсы, используемые классом 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.ValueTask

Public Overridable Function DisposeAsync () As ValueTask

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

ValueTask

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

Реализации

DisposeAsync()

Комментарии

Метод DisposeAsync позволяет выполнять ресурсоемкую операцию удаления, не блокируя поток main. Это соображение, связанное с производительностью, особенно важно в приложениях Магазина Windows 8.x и классических приложениях, в которых длительная потоковая операция может блокировать поток пользовательского интерфейса и создавать впечатление, что приложение не работает. Асинхронные методы используются в сочетании с ключевыми словами async и await в Visual Basic и C#.

Этот метод удаляет поток, записывая все изменения в резервное хранилище и закрывая поток для освобождения ресурсов.

Вызов DisposeAsync позволяет перераспределить ресурсы, используемые , Stream для других целей. Дополнительные сведения см. в разделе Очистка неуправляемых ресурсов.

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