Teilen über


Stream.DisposeAsync Methode

Definition

Gibt die nicht verwalteten Ressourcen, die von der Stream verwendet werden, asynchron frei.

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 Löschvorgang darstellt.

Implementiert

Hinweise

Mit DisposeAsync der -Methode können Sie einen ressourcenintensiven Entsorgevorgang ausführen, ohne den Standard Thread zu blockieren. Diese Überlegungen zur Leistung sind insbesondere in einer Windows 8.x Store-App oder Desktop-App wichtig, bei der ein zeitaufwendiger Streamingvorgang den UI-Thread blockieren kann und es dann den Anschein hat, dass Ihre App nicht funktioniert. Die asynchronen Methoden werden in Verbindung mit den async Schlüsselwörtern und await in Visual Basic und C# verwendet.

Diese Methode entfernt den Stream, indem alle Änderungen in den Sicherungsspeicher geschrieben und der Stream geschlossen wird, um Ressourcen freizugeben.

Durch aufrufen DisposeAsync können die von verwendeten Stream Ressourcen für andere Zwecke neu zugeordnet werden. Weitere Informationen finden Sie unter Bereinigen nicht verwalteter Ressourcen.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung 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. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten Dispose()Ausnahmen.

Gilt für: