Stream.DisposeAsync Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Zdroj:

Stream.cs

Asynchronně uvolní nespravované prostředky, které Streampoužívá .

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

Návraty

ValueTask

Úloha, která představuje asynchronní operaci dispose.

Implementuje

DisposeAsync()

Poznámky

Metoda DisposeAsync umožňuje provést operaci odstranění náročných na prostředky bez blokování hlavního vlákna. Tento faktor výkonu je zvlášť důležitý v aplikaci Windows 8.x Store nebo desktopové aplikaci, kde může časově náročná operace streamu blokovat vlákno uživatelského rozhraní a aplikace vypadat, jako by nefungovala. Asynchronní metody se používají ve spojení s klíčovými async slovy a await v jazyce Visual Basic a C#.

Tato metoda likviduje datový proud zápisem všech změn do záložního úložiště a zavřením datového proudu uvolnit prostředky.

Volání DisposeAsync umožňuje přerozdělit prostředky používané nástrojem Stream pro jiné účely. Další informace najdete v tématu Čištění nespravovaných prostředků.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Dispose().