Stream.DisposeAsync Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.dll

Źródło:

Stream.cs

Asynchronicznie zwalnia niezarządzane zasoby używane przez Streamprogram .

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

Zwraca

ValueTask

Zadanie reprezentujące operację usuwania asynchronicznego.

Implementuje

DisposeAsync()

Uwagi

Metoda DisposeAsync umożliwia wykonywanie operacji usuwania intensywnie korzystającej z zasobów bez blokowania głównego wątku. Ta kwestia wydajności jest szczególnie ważna w aplikacji ze sklepu Windows 8.x lub aplikacji klasycznej, w której czasochłonna operacja strumienia może zablokować wątek interfejsu użytkownika i sprawić, że aplikacja będzie wyświetlana tak, jakby nie działała. Metody asynchroniczne są używane w połączeniu ze słowami kluczowymi async i await w Visual Basic i C#.

Ta metoda usuwa strumień, zapisując wszelkie zmiany w magazynie zaplecza i zamykając strumień w celu wydania zasobów.

Wywołanie DisposeAsync umożliwia przydział zasobów używanych przez element do ich przydziału Stream do innych celów. Aby uzyskać więcej informacji, zobacz Czyszczenie niezarządzanych zasobów.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Dispose()usługę .