Stream.DisposeAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.ValueTaskPublic Overridable Function DisposeAsync () As ValueTaskGibt 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.
