Stream.DisposeAsync Methode

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Quelle:

Stream.cs

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

ValueTask

Eine Aufgabe, die den asynchronen Löschvorgang darstellt.

Implementiert

DisposeAsync()

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.