DbCommand.ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) 方法

定義

命名空間:
System.Data.Common
組件:
System.Data.Common.dll
組件:
System.Data.dll
組件:
netstandard.dll

提供者應實作此方法，以提供非預設的超載實 ExecuteReader 作。

預設實作會呼叫同步 ExecuteReader() 方法並回傳已完成的任務，阻擋呼叫執行緒。 預設實作若傳遞已取消的取消標記，會回傳已取消的任務。 ExecuteReader 拋出的異常會透過回傳的任務異常屬性來傳達。

此方法接受一個取消標記，可用來請求提前取消操作。 實施單位可能會忽略此請求。

protected:
 virtual System::Threading::Tasks::Task<System::Data::Common::DbDataReader ^> ^ ExecuteDbDataReaderAsync(System::Data::CommandBehavior behavior, System::Threading::CancellationToken cancellationToken);
protected virtual System.Threading.Tasks.Task<System.Data.Common.DbDataReader> ExecuteDbDataReaderAsync(System.Data.CommandBehavior behavior, System.Threading.CancellationToken cancellationToken);
abstract member ExecuteDbDataReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.Common.DbDataReader>
override this.ExecuteDbDataReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.Common.DbDataReader>
Protected Overridable Function ExecuteDbDataReaderAsync (behavior As CommandBehavior, cancellationToken As CancellationToken) As Task(Of DbDataReader)

參數

behavior
CommandBehavior

一個 的 CommandBehavior實例，指定指令執行與資料檢索的選項。

cancellationToken
CancellationToken

一個取消非同步操作的標記。

傳回

Task<DbDataReader>

一個代表非同步操作的任務。

例外狀況

DbException

執行指令時發生錯誤。

ArgumentException

一個無效 CommandBehavior 的數值。

OperationCanceledException

取消令牌也被取消了。 此例外會儲存在回傳的任務中。

備註

欲了解更多非同步程式設計的資訊，請參閱非同步程式設計。

此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 ExecuteDbDataReader(CommandBehavior)拋出的例外。

適用於

另請參閱