Stream.DisposeAsync Methode

Definition

Gibt asynchron die nicht verwalteten Ressourcen frei, die von der 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

Gibt zurück

Eine Aufgabe, die den asynchronen Dispose-Vorgang darstellt.

Implementiert

Hinweise

Mit der DisposeAsync Methode können Sie einen ressourcenintensiven Dispose-Vorgang ausführen, ohne den Hauptthread zu blockieren. Diese Leistungsüberlegung ist in einer Windows 8.x Store-App oder Desktop-App besonders wichtig, bei der ein zeitaufwendiger Streamvorgang den UI-Thread blockieren und ihre App so erscheinen lässt, als ob sie nicht funktioniert. Die asynchronen Methoden werden in Verbindung mit den Schlüsselwörtern async in Visual Basic und C# await verwendet.

Mit dieser Methode wird der Datenstrom gelöscht, indem Änderungen am Sicherungsspeicher geschrieben und der Datenstrom geschlossen wird, um Ressourcen freizugeben.

Das Aufrufen DisposeAsync ermöglicht es, die von der Stream verwendeten Ressourcen für andere Zwecke neu zugewiesen zu werden. Weitere Informationen finden Sie unter Bereinigen nicht verwalteter Ressourcen.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Dispose().

Gilt für: