DbDataReader.DisposeAsync 方法

定義

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

C#
public virtual System.Threading.Tasks.ValueTask DisposeAsync();

傳回

代表非同步作業的 ValueTask

實作

備註

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

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

注意

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

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

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

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

適用於

產品 版本
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Standard 2.1