SqlCommand.ExecuteReaderAsync 方法

定義

命名空間:: System.Data.SqlClient

組件:: System.Data.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

啟動非同步執行由此 SqlCommand描述的 Transact-SQL 語句或儲存程序。

多載

名稱	Description
ExecuteReaderAsync()	一個非同步版本的 ExecuteReader()，將傳送 CommandText 到並 Connection 建 SqlDataReader構。例外將透過回傳的任務物件回報。
ExecuteReaderAsync(CommandBehavior)	一個非同步版本 ExecuteReader(CommandBehavior)的，將傳送 CommandText 到 Connection，並建立 SqlDataReader。例外將透過回傳的任務物件回報。
ExecuteReaderAsync(CancellationToken)	一個非同步版本的 ExecuteReader()，將傳送 CommandText 到並 Connection 建 SqlDataReader構。取消標記可用來請求在指令逾時前放棄操作。例外將透過回傳的任務物件回報。
ExecuteReaderAsync(CommandBehavior, CancellationToken)	一個非同步版本 ExecuteReader(CommandBehavior)的，將傳送 CommandText 到 Connection，並建立 SqlDataReader 取消標記可用來請求在指令逾時前放棄操作。例外將透過回傳的任務物件回報。

備註

欲了解更多關於.NET框架Data Provider for SQL Server 非同步程式設計的資訊，請參見非同步程式設計。

ExecuteReaderAsync()

一個非同步版本的 ExecuteReader()，將傳送 CommandText 到並 Connection 建 SqlDataReader構。例外將透過回傳的任務物件回報。

public:
 System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync();

public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync();

override this.ExecuteReaderAsync : unit -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync () As Task(Of SqlDataReader)

傳回

Task<SqlDataReader>

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

例外狀況

InvalidCastException

當設定為 SqlDbType時，會使用除 Binary 或 VarBinary 以外的。Value Stream 欲了解更多串流資訊，請參閱 SqlClient 串流支援。

-或-

SqlDbType除了 Char、NChar、NVarChar、VarChar 或 Xml，當設定為時，會使用其他 Char、Value、NVarChar、TextReader 或 Xml。

-或-

當設定為 SqlDbType時，會使用 Xml 以外的。Value XmlReader

ArgumentException

一個無效 CommandBehavior 的數值。

InvalidOperationException

在同一 ExecuteReaderAsync() 個實例呼叫超過一次，任務才完成。

-或-

在 SqlConnection 串流操作中關閉或掉落。欲了解更多串流資訊，請參閱 SqlClient 串流支援。

-或-

Context Connection=true 在連接字串中指定。

SqlException

SQL Server 執行命令文字時回傳錯誤。

-或-

串流操作中發生了一次超時。欲了解更多串流資訊，請參閱 SqlClient 串流支援。

IOException

在串流操作中，物件或發生Stream XmlReader TextReader錯誤。欲了解更多串流資訊，請參閱 SqlClient 串流支援。

ObjectDisposedException

Stream該， XmlReader 或TextReader物件在串流操作中被關閉。欲了解更多串流資訊，請參閱 SqlClient 串流支援。

備註

欲了解更多關於.NET框架Data Provider for SQL Server 非同步程式設計的資訊，請參見非同步程式設計。

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

另請參閱

ADO.NET 概觀

適用於

ExecuteReaderAsync(CommandBehavior)

一個非同步版本 ExecuteReader(CommandBehavior)的，將傳送 CommandText 到 Connection，並建立 SqlDataReader。例外將透過回傳的任務物件回報。

public:
 System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Data::CommandBehavior behavior);

public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync(System.Data.CommandBehavior behavior);

override this.ExecuteReaderAsync : System.Data.CommandBehavior -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync (behavior As CommandBehavior) As Task(Of SqlDataReader)

參數

behavior: CommandBehavior

語句執行與資料檢索的選項。當設定為 Default時， ReadAsync(CancellationToken) 會讀取整列資料，然後返回完整的任務。

傳回

Task<SqlDataReader>

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

例外狀況

InvalidCastException

當設定為 SqlDbType時，會使用除 Binary 或 VarBinary 以外的。Value Stream 欲了解更多串流資訊，請參閱 SqlClient 串流支援。

-或-

SqlDbType除了 Char、NChar、NVarChar、VarChar 或 Xml，當設定為時，會使用其他 Char、Value、NVarChar、TextReader 或 Xml。

-或-

當設定為 SqlDbType時，會使用 Xml 以外的。Value XmlReader

ArgumentException

一個無效 CommandBehavior 的數值。

InvalidOperationException

在同一 ExecuteReaderAsync(CommandBehavior) 個實例呼叫超過一次，任務才完成。

-或-

在 SqlConnection 串流操作中關閉或掉落。欲了解更多串流資訊，請參閱 SqlClient 串流支援。

-或-

Context Connection=true 在連接字串中指定。

SqlException

SQL Server 執行命令文字時回傳錯誤。

-或-

串流操作中發生了一次超時。欲了解更多串流資訊，請參閱 SqlClient 串流支援。

IOException

在串流操作中，物件或發生Stream XmlReader TextReader錯誤。欲了解更多串流資訊，請參閱 SqlClient 串流支援。

ObjectDisposedException

Stream該， XmlReader 或TextReader物件在串流操作中被關閉。欲了解更多串流資訊，請參閱 SqlClient 串流支援。

備註

欲了解更多關於.NET框架Data Provider for SQL Server 非同步程式設計的資訊，請參見非同步程式設計。

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

另請參閱

ADO.NET 概觀

適用於

ExecuteReaderAsync(CancellationToken)

一個非同步版本的 ExecuteReader()，將傳送 CommandText 到並 Connection 建 SqlDataReader構。

取消標記可用來請求在指令逾時前放棄操作。例外將透過回傳的任務物件回報。

public:
 System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync(System.Threading.CancellationToken cancellationToken);

override this.ExecuteReaderAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync (cancellationToken As CancellationToken) As Task(Of SqlDataReader)

參數

cancellationToken: CancellationToken

取消指示。

傳回

Task<SqlDataReader>

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

例外狀況

InvalidCastException

當設定為 SqlDbType時，會使用除 Binary 或 VarBinary 以外的。Value Stream 欲了解更多串流資訊，請參閱 SqlClient 串流支援。

-或-

SqlDbType除了 Char、NChar、NVarChar、VarChar 或 Xml，當設定為時，會使用其他 Char、Value、NVarChar、TextReader 或 Xml。

-或-

當設定為 SqlDbType時，會使用 Xml 以外的。Value XmlReader

ArgumentException

一個無效 CommandBehavior 的數值。

InvalidOperationException

在同一 ExecuteReaderAsync(CommandBehavior, CancellationToken) 個實例呼叫超過一次，任務才完成。

-或-

在 SqlConnection 串流操作中關閉或掉落。欲了解更多串流資訊，請參閱 SqlClient 串流支援。

-或-

Context Connection=true 在連接字串中指定。

SqlException

SQL Server 執行命令文字時回傳錯誤。

-或-

串流操作中發生了一次超時。欲了解更多串流資訊，請參閱 SqlClient 串流支援。

IOException

在串流操作中，物件或發生Stream XmlReader TextReader錯誤。欲了解更多串流資訊，請參閱 SqlClient 串流支援。

ObjectDisposedException

Stream該， XmlReader 或TextReader物件在串流操作中被關閉。欲了解更多串流資訊，請參閱 SqlClient 串流支援。

OperationCanceledException

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

備註

欲了解更多關於.NET框架Data Provider for SQL Server 非同步程式設計的資訊，請參見非同步程式設計。

另請參閱

ADO.NET 概觀

適用於

ExecuteReaderAsync(CommandBehavior, CancellationToken)

一個非同步版本 ExecuteReader(CommandBehavior)的，將傳送 CommandText 到 Connection，並建立 SqlDataReader

取消標記可用來請求在指令逾時前放棄操作。例外將透過回傳的任務物件回報。

public:
 System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Data::CommandBehavior behavior, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync(System.Data.CommandBehavior behavior, System.Threading.CancellationToken cancellationToken);

override this.ExecuteReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync (behavior As CommandBehavior, cancellationToken As CancellationToken) As Task(Of SqlDataReader)

參數

behavior: CommandBehavior

語句執行與資料檢索的選項。當設定為 Default時， ReadAsync(CancellationToken) 會讀取整列資料，然後返回完整的任務。

cancellationToken: CancellationToken

取消指示。

傳回

Task<SqlDataReader>

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

例外狀況

InvalidCastException

當設定為 SqlDbType時，會使用除 Binary 或 VarBinary 以外的。Value Stream 欲了解更多串流資訊，請參閱 SqlClient 串流支援。

-或-

SqlDbType除了 Char、NChar、NVarChar、VarChar 或 Xml，當設定為時，會使用其他 Char、Value、NVarChar、TextReader 或 Xml。

-或-

當設定為 SqlDbType時，會使用 Xml 以外的。Value XmlReader

ArgumentException

一個無效 CommandBehavior 的數值。

InvalidOperationException

在同一 ExecuteReaderAsync(CommandBehavior, CancellationToken) 個實例呼叫超過一次，任務才完成。

-或-

在 SqlConnection 串流操作中關閉或掉落。欲了解更多串流資訊，請參閱 SqlClient 串流支援。

-或-

Context Connection=true 在連接字串中指定。

SqlException

SQL Server 執行命令文字時回傳錯誤。

-或-

串流操作中發生了一次超時。欲了解更多串流資訊，請參閱 SqlClient 串流支援。

IOException

在串流操作中，物件或發生Stream XmlReader TextReader錯誤。欲了解更多串流資訊，請參閱 SqlClient 串流支援。

ObjectDisposedException

Stream該， XmlReader 或TextReader物件在串流操作中被關閉。欲了解更多串流資訊，請參閱 SqlClient 串流支援。

OperationCanceledException

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

備註

欲了解更多關於.NET框架Data Provider for SQL Server 非同步程式設計的資訊，請參見非同步程式設計。

另請參閱

ADO.NET 概觀

適用於

意見反應

此頁面對您有幫助嗎？