DbDataReader.DisposeAsync Methode

Definition

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Quelle:

DbDataReader.cs

Gibt alle von der aktuellen Instanz der DbDataReader-Klasse verwendeten Ressourcen 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 ValueTask, die den asynchronen Vorgang darstellt

Implementiert

DisposeAsync()

Hinweise

Rufen Sie auf Dispose , oder DisposeAsync wenn Sie die DbDataReaderVerwendung abgeschlossen haben. Beim Aufrufen einer dieser Methoden wird der DbDataReader Zustand nicht mehr verwendet. Nach dem Löschen müssen Sie alle Verweise auf den DbDataReader freigeben, damit der Garbage Collector den Arbeitsspeicher, den der DbDataReader belegt hat, wieder freigeben kann.

Weitere Informationen finden Sie unter Bereinigen nicht verwalteter Ressourcen und Implementieren einer Dispose-Methode.

Hinweis

Entsorgen Sie immer, bevor Sie Ihren letzten Verweis auf den DbDataReaderfreigeben. Andernfalls bleiben die verwendeten Ressourcen reserviert, bis die Garbage Collection die DbDataReader-Methode des Finalize-Objekts aufruft.

Die Standardimplementierung dieser asynchronen Methode delegiert an ihre synchrone Entsprechung und gibt einen abgeschlossenen ValueTaskzurück, der den aufrufenden Thread möglicherweise blockiert.

Datenanbieter, die asynchrone Programmierung unterstützen, sollten die Standardimplementierung mithilfe asynchroner E/A-Vorgänge außer Kraft setzen.

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.