DbCommand.ExecuteReaderAsync 方法

定義

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

一個非同步版本 ExecuteReader的 ，該指令會對其連線執行指令，回傳 a DbDataReader 可用來存取結果。

多載

名稱 Description
ExecuteReaderAsync()

一個非同步版本 ExecuteReader的 ，該指令會對其連線執行指令，回傳 a DbDataReader 可用來存取結果。

使用 CancellationToken.None 來調用 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) 。
ExecuteReaderAsync(CommandBehavior)

一個非同步版本 ExecuteReader的 ，該指令會對其連線執行指令，回傳 a DbDataReader 可用來存取結果。

喚起 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)。
ExecuteReaderAsync(CancellationToken)

一個非同步版本 ExecuteReader的 ，該指令會對其連線執行指令，回傳 a DbDataReader 可用來存取結果。

喚起 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)。
ExecuteReaderAsync(CommandBehavior, CancellationToken)

喚起 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)。

備註

託管提供者的實作者必須呼叫ExecuteDbDataReaderAsyncExecuteReaderAsync。 欲了解更多非同步程式設計的資訊，請參閱非同步程式設計。

ExecuteReaderAsync()

一個非同步版本 ExecuteReader的 ，該指令會對其連線執行指令，回傳 a DbDataReader 可用來存取結果。

使用 CancellationToken.None 來調用 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) 。

public:
 System::Threading::Tasks::Task<System::Data::Common::DbDataReader ^> ^ ExecuteReaderAsync();
public System.Threading.Tasks.Task<System.Data.Common.DbDataReader> ExecuteReaderAsync();
member this.ExecuteReaderAsync : unit -> System.Threading.Tasks.Task<System.Data.Common.DbDataReader>
Public Function ExecuteReaderAsync () As Task(Of DbDataReader)

傳回

Task<DbDataReader>

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

例外狀況

DbException

執行指令時發生錯誤。

ArgumentException

一個無效 CommandBehavior 的數值。

備註

託管提供者的實作者必須呼叫ExecuteDbDataReaderAsyncExecuteReaderAsync。 欲了解更多非同步程式設計的資訊，請參閱非同步程式設計。

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

另請參閱

適用於

ExecuteReaderAsync(CommandBehavior)

一個非同步版本 ExecuteReader的 ，該指令會對其連線執行指令，回傳 a DbDataReader 可用來存取結果。

喚起 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)。

public:
 System::Threading::Tasks::Task<System::Data::Common::DbDataReader ^> ^ ExecuteReaderAsync(System::Data::CommandBehavior behavior);
public System.Threading.Tasks.Task<System.Data.Common.DbDataReader> ExecuteReaderAsync(System.Data.CommandBehavior behavior);
member this.ExecuteReaderAsync : System.Data.CommandBehavior -> System.Threading.Tasks.Task<System.Data.Common.DbDataReader>
Public Function ExecuteReaderAsync (behavior As CommandBehavior) As Task(Of DbDataReader)

參數

behavior
CommandBehavior

其中一個列舉值，用來指定指令應該如何執行以及資料應該如何取得。

傳回

Task<DbDataReader>

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

例外狀況

DbException

執行指令時發生錯誤。

ArgumentException

一個無效 CommandBehavior 的數值。

備註

託管提供者的實作者必須呼叫ExecuteDbDataReaderAsyncExecuteReaderAsync。 欲了解更多非同步程式設計的資訊，請參閱非同步程式設計。

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

另請參閱

適用於

ExecuteReaderAsync(CancellationToken)

一個非同步版本 ExecuteReader的 ，該指令會對其連線執行指令，回傳 a DbDataReader 可用來存取結果。

喚起 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)。

public:
 System::Threading::Tasks::Task<System::Data::Common::DbDataReader ^> ^ ExecuteReaderAsync(System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Data.Common.DbDataReader> ExecuteReaderAsync(System.Threading.CancellationToken cancellationToken);
member this.ExecuteReaderAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.Common.DbDataReader>
Public Function ExecuteReaderAsync (cancellationToken As CancellationToken) As Task(Of DbDataReader)

參數

cancellationToken
CancellationToken

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

傳回

Task<DbDataReader>

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

例外狀況

DbException

執行指令時發生錯誤。

ArgumentException

一個無效 CommandBehavior 的數值。

OperationCanceledException

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

備註

託管提供者的實作者必須呼叫ExecuteDbDataReaderAsyncExecuteReaderAsync。 欲了解更多非同步程式設計的資訊，請參閱非同步程式設計。

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

另請參閱

適用於

ExecuteReaderAsync(CommandBehavior, CancellationToken)

喚起 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)。

public:
 System::Threading::Tasks::Task<System::Data::Common::DbDataReader ^> ^ ExecuteReaderAsync(System::Data::CommandBehavior behavior, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Data.Common.DbDataReader> ExecuteReaderAsync(System.Data.CommandBehavior behavior, System.Threading.CancellationToken cancellationToken);
member this.ExecuteReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.Common.DbDataReader>
Public Function ExecuteReaderAsync (behavior As CommandBehavior, cancellationToken As CancellationToken) As Task(Of DbDataReader)

參數

behavior
CommandBehavior

這是指定指令行為的列舉值之一。

cancellationToken
CancellationToken

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

傳回

Task<DbDataReader>

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

例外狀況

DbException

執行指令時發生錯誤。

ArgumentException

一個無效 CommandBehavior 的數值。

OperationCanceledException

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

備註

託管提供者的實作者必須呼叫ExecuteDbDataReaderAsyncExecuteReaderAsync。 欲了解更多非同步程式設計的資訊，請參閱非同步程式設計。

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

另請參閱

適用於