SqlCommand.ExecuteReaderAsync Metoda

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

Přetížení

ExecuteReaderAsync()	Asynchronní verze nástroje ExecuteReader() , která odešle CommandText objektu Connection a vytvoří SqlDataReader . Výjimky budou hlášeny prostřednictvím vráceného objektu Task.
ExecuteReaderAsync(CommandBehavior)	Asynchronní verze nástroje ExecuteReader(CommandBehavior) , která odešle CommandText objekt do Connection a vytvoří SqlDataReader . Výjimky budou hlášeny prostřednictvím vráceného objektu Task.
ExecuteReaderAsync(CancellationToken)	Asynchronní verze nástroje ExecuteReader() , která odešle CommandText objektu Connection a vytvoří SqlDataReader . Token zrušení lze použít k žádosti o opuštění operace před vypršením časového limitu příkazu. Výjimky budou hlášeny prostřednictvím vráceného objektu Task.
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Asynchronní verze nástroje ExecuteReader(CommandBehavior) , která odešle CommandTextConnection do a vytvoří SqlDataReader token zrušení, lze použít k požadavku, aby operace byla ukončena před vypršením časového limitu příkazu. Výjimky budou hlášeny prostřednictvím vráceného objektu Task.

ExecuteReaderAsync()

Asynchronní verze nástroje ExecuteReader() , která odešle CommandText objektu Connection a vytvoří SqlDataReader . Výjimky budou hlášeny prostřednictvím vráceného objektu Task.

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

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

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

Public Function ExecuteReaderAsync () As Task(Of SqlDataReader)

Návraty

Task<SqlDataReader>

Úloha představující asynchronní operaci

Výjimky

InvalidCastException

Při SqlDbType nastavení na Stream hodnotu byla použita Value jiná hodnota než Binary nebo VarBinary. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

-nebo-

Při SqlDbType nastavení na TextReader hodnotu se použila Value jiná hodnota než Char, NChar, NVarChar, VarChar nebo XML.

-nebo-

Při SqlDbType nastavení na XmlReader hodnotu byla použita Value jiná hodnota než XML.

ArgumentException

Neplatná CommandBehavior hodnota.

InvalidOperationException

Volání ExecuteReaderAsync() více než jednou pro stejnou instanci před dokončením úkolu

-nebo-

Zavřený SqlConnection nebo vynechaný během operace streamování. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

SqlException

SQL Server vrátil chybu při provádění textu příkazu.

-nebo-

Během operace streamování došlo k vypršení časového limitu. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

IOException

Během operace streamování došlo v objektu Stream nebo TextReaderXmlReader k chybě. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

ObjectDisposedException

Objekt Stream nebo XmlReaderTextReader byl uzavřen během operace streamování. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

Poznámky

Další informace o asynchronním programování v zprostředkovateli dat rozhraní .NET Framework pro SQL Server najdete v tématu Asynchronní programování.

Poznámka

U dlouhotrvajících dotazů na serveru zvažte použití ExecuteReader kvůli známému problému se zrušením dotazů prostřednictvím tokenu zrušení. Zvažte také zrušení provádění pomocí Cancel metody .

ExecuteReaderAsync(CommandBehavior)

Asynchronní verze nástroje ExecuteReader(CommandBehavior) , která odešle CommandText objekt do Connection a vytvoří SqlDataReader . Výjimky budou hlášeny prostřednictvím vráceného objektu Task.

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

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

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

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

Parametry

behavior

CommandBehavior

Možnosti pro provádění příkazů a načítání dat Když je nastavená naDefault přečte ReadAsync(CancellationToken) celý řádek před vrácením dokončeného úkolu.

Návraty

Task<SqlDataReader>

Úloha představující asynchronní operaci

Výjimky

InvalidCastException

Při SqlDbType nastavení na Stream hodnotu byla použita Value jiná hodnota než Binary nebo VarBinary. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

-nebo-

Při SqlDbType nastavení na TextReader hodnotu se použila Value jiná hodnota než Char, NChar, NVarChar, VarChar nebo XML.

-nebo-

Při SqlDbType nastavení na XmlReader hodnotu byla použita Value jiná hodnota než XML.

ArgumentException

Neplatná CommandBehavior hodnota.

InvalidOperationException

Volání ExecuteReaderAsync(CommandBehavior) více než jednou pro stejnou instanci před dokončením úkolu

-nebo- SqlConnection uzavřeno nebo vyřazeno během operace streamování. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

SqlException

SQL Server vrátil chybu při provádění textu příkazu.

-nebo-

Během operace streamování došlo k vypršení časového limitu. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

IOException

Během operace streamování došlo v objektu Stream nebo TextReaderXmlReader k chybě. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

ObjectDisposedException

Objekt Stream nebo XmlReaderTextReader byl uzavřen během operace streamování. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

Poznámky

Další informace o asynchronním programování v zprostředkovateli dat rozhraní .NET Framework pro SQL Server najdete v tématu Asynchronní programování.

ExecuteReaderAsync(CancellationToken)

Asynchronní verze nástroje ExecuteReader() , která odešle CommandText objektu Connection a vytvoří SqlDataReader .

Token zrušení lze použít k žádosti o opuštění operace před vypršením časového limitu příkazu. Výjimky budou hlášeny prostřednictvím vráceného objektu Task.

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

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

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

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

Parametry

cancellationToken

CancellationToken

Instrukce zrušení

Návraty

Task<SqlDataReader>

Úloha představující asynchronní operaci

Výjimky

InvalidCastException

Při SqlDbType nastavení na Stream hodnotu byla použita Value jiná hodnota než Binary nebo VarBinary. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

-nebo-

Při SqlDbType nastavení na TextReader hodnotu se použila Value jiná hodnota než Char, NChar, NVarChar, VarChar nebo XML.

-nebo-

Při SqlDbType nastavení na XmlReader hodnotu byla použita Value jiná hodnota než XML.

ArgumentException

Neplatná CommandBehavior hodnota.

InvalidOperationException

Volání ExecuteReaderAsync(CommandBehavior, CancellationToken) více než jednou pro stejnou instanci před dokončením úkolu

-nebo-

Zavřený SqlConnection nebo vynechaný během operace streamování. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

SqlException

SQL Server vrátil chybu při provádění textu příkazu.

-nebo-

Během operace streamování došlo k vypršení časového limitu. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

IOException

Během operace streamování došlo v objektu Stream nebo TextReaderXmlReader k chybě. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

ObjectDisposedException

Objekt Stream nebo XmlReaderTextReader byl uzavřen během operace streamování. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

Poznámky

Další informace o asynchronním programování v zprostředkovateli dat rozhraní .NET Framework pro SQL Server najdete v tématu Asynchronní programování.

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Asynchronní verze nástroje ExecuteReader(CommandBehavior) , která odešle CommandTextConnection do a vytvoří SqlDataReader token zrušení, lze použít k požadavku, aby operace byla ukončena před vypršením časového limitu příkazu. Výjimky budou hlášeny prostřednictvím vráceného objektu Task.

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

public System.Threading.Tasks.Task<Microsoft.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<Microsoft.Data.SqlClient.SqlDataReader>

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

Parametry

behavior

CommandBehavior

Možnosti pro provádění příkazů a načítání dat Když je nastavená naDefault přečte ReadAsync(CancellationToken) celý řádek před vrácením dokončeného úkolu.

cancellationToken

CancellationToken

Instrukce zrušení

Návraty

Task<SqlDataReader>

Úloha představující asynchronní operaci

Výjimky

InvalidCastException

Při SqlDbType nastavení na Stream hodnotu byla použita Value jiná hodnota než Binary nebo VarBinary. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

-nebo-

Při SqlDbType nastavení na TextReader hodnotu se použila Value jiná hodnota než Char, NChar, NVarChar, VarChar nebo XML.

-nebo-

Při SqlDbType nastavení na XmlReader hodnotu byla použita Value jiná hodnota než XML.

ArgumentException

Neplatná CommandBehavior hodnota.

InvalidOperationException

Volání ExecuteReaderAsync(CommandBehavior, CancellationToken) více než jednou pro stejnou instanci před dokončením úkolu

-nebo-

Zavřený SqlConnection nebo vynechaný během operace streamování. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

SqlException

SQL Server vrátil chybu při provádění textu příkazu.

-nebo-

Během operace streamování došlo k vypršení časového limitu. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

IOException

Během operace streamování došlo v objektu Stream nebo TextReaderXmlReader k chybě. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

ObjectDisposedException

Objekt Stream nebo XmlReaderTextReader byl uzavřen během operace streamování. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

Poznámky

Další informace o asynchronním programování v zprostředkovateli dat rozhraní .NET Framework pro SQL Server najdete v tématu Asynchronní programování.