DbDataReader.DisposeAsync 方法

定義

命名空間:

System.Data.Common

組件:

System.Data.Common.dll

來源:

DbDataReader.cs

以非同步方式將 DbDataReader 類別的目前執行個體所使用所有資源釋出。

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

傳回

ValueTask

代表非同步作業的 ValueTask。

實作

DisposeAsync()

備註

呼叫 Dispose 或 DisposeAsync 完成使用 DbDataReader時。 呼叫其中一種方法會讓 保持 DbDataReader 無法使用狀態。 處置之後，您必須釋放 的所有參考， DbDataReader 讓垃圾收集行程可以回收佔用的記憶體 DbDataReader 。

如需詳細資訊，請參閱 清除 Unmanaged 資源 及 實作 Dispose 方法。

注意

在您釋放對 的最後一 DbDataReader個參考之前，請一律處置 。 否則工作窗格所使用的資源不會釋放，直到記憶體回收行程呼叫 DbDataReader 物件的 Finalize 方法。

這個異步方法的預設實作會委派給其同步對應專案，並傳回已完成 ValueTask的 ，可能會封鎖呼叫線程。

支援 異步程式設計 的數據提供者應該使用異步 I/O 作業覆寫預設實作。

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用狀況例外狀況，例如 ArgumentException，仍會同步擲回。 如需預存的例外狀況，請參閱 所 Dispose()擲回的例外狀況。