SqlCommand.ExecuteReaderAsync Metoda

Definice

Obor názvů:: Microsoft.Data.SqlClient

Sestavení:: Microsoft.Data.SqlClient.dll

Balíček:: Microsoft.Data.SqlClient v1.0.19269.1

Balíček:: Microsoft.Data.SqlClient v1.1.4

Balíček:: Microsoft.Data.SqlClient v2.0.1

Balíček:: Microsoft.Data.SqlClient v2.1.4

Balíček:: Microsoft.Data.SqlClient v3.0.1

Balíček:: Microsoft.Data.SqlClient v3.1.0

Balíček:: Microsoft.Data.SqlClient v4.0.1

Balíček:: Microsoft.Data.SqlClient v4.1.0

Balíček:: Microsoft.Data.SqlClient v5.0.0

Balíček:: Microsoft.Data.SqlClient v5.1.0

Balíček:: Microsoft.Data.SqlClient v5.2.0

Balíček:: Microsoft.Data.SqlClient v6.0.2

Balíček:: Microsoft.Data.SqlClient v6.1.3

Balíček:: Microsoft.Data.SqlClient v7.0.1

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Přetížení

Name	Description
ExecuteReaderAsync()	Asynchronní verze ExecuteReader(), která odešle CommandText do Connection a vytvoří SqlDataReader. Výjimky budou hlášeny prostřednictvím vráceného objektu Task.
ExecuteReaderAsync(CommandBehavior)	Asynchronní verze ExecuteReader(CommandBehavior), která odešle CommandText na Connection, a sestavení .SqlDataReader Výjimky budou hlášeny prostřednictvím vráceného objektu Task.
ExecuteReaderAsync(CancellationToken)	Asynchronní verze ExecuteReader(), která odešle CommandText do Connection a vytvoří SqlDataReader. Token zrušení lze použít k vyžádání, aby byla operace zruš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(CommandBehavior, CancellationToken)	Asynchronní verze ExecuteReader(CommandBehavior), která odešle CommandText do Connectiona sestavení SqlDataReader tokenu zrušení lze použít k vyžádání, aby operace byla opuštěna před vypršením časového limitu příkazu. Výjimky budou hlášeny prostřednictvím vráceného objektu Task.

ExecuteReaderAsync()

Zdroj:: SqlCommand.cs

Zdroj:: SqlCommand.cs

Zdroj:: SqlCommand.cs

Zdroj:: SqlCommand.cs

Asynchronní verze ExecuteReader(), která odešle CommandText 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();

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

Jiný SqlDbType než Binary nebo VarBinary byl použit při Value nastavení Stream. Další informace o streamování najdete v tématu Podpora streamování SqlClient.
Jiný SqlDbType než Char, , NChar, NVarCharVarCharnebo Xml byl použit při Value nastavení TextReader.
Jiné SqlDbType , než Xml bylo použito při Value nastavení XmlReader.

ArgumentException

Neplatná CommandBehavior hodnota.

InvalidOperationException

Volání ExecuteReaderAsync() více než jednou pro stejnou instanci před dokončením úkolu
Zavřený SqlConnection nebo ukončený 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.
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 k chybě nebo Stream XmlReader TextReader objektu. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

ObjectDisposedException

Stream Objekt XmlReadernebo TextReader objekt 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ředkovatel dat .NET Framework pro SQL Server naleznete v tématu Synchronous Programming.

Note

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.

Platí pro

ExecuteReaderAsync(CommandBehavior)

Zdroj:: SqlCommand.cs

Zdroj:: SqlCommand.cs

Zdroj:: SqlCommand.cs

Zdroj:: SqlCommand.cs

Asynchronní verze ExecuteReader(CommandBehavior), která odešle CommandText na Connection, a sestavení .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 spouštění příkazů a načítání dat Pokud je nastavená hodnota Default, ReadAsync(CancellationToken) přečte celý řádek před vrácením dokončeného úkolu.

Návraty

Task<SqlDataReader>

Úloha představující asynchronní operaci.

Výjimky

InvalidCastException

Jiný SqlDbType než Binary nebo VarBinary byl použit při Value nastavení Stream. Další informace o streamování najdete v tématu Podpora streamování SqlClient.
Jiný SqlDbType než Char, , NChar, NVarCharVarCharnebo Xml byl použit při Value nastavení TextReader.
Jiné SqlDbType , než Xml bylo použito při Value nastavení XmlReader.

ArgumentException

Neplatná CommandBehavior hodnota.

InvalidOperationException

Volání ExecuteReaderAsync(CommandBehavior) více než jednou pro stejnou instanci před dokončením úkolu
SqlConnection zavřené nebo ukončené 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.
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 k chybě nebo Stream XmlReader TextReader objektu. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

ObjectDisposedException

Stream Objekt XmlReadernebo TextReader objekt 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ředkovatel dat .NET Framework pro SQL Server naleznete v tématu Synchronous Programming.

Platí pro

ExecuteReaderAsync(CancellationToken)

Zdroj:: SqlCommand.cs

Zdroj:: SqlCommand.cs

Zdroj:: SqlCommand.cs

Zdroj:: SqlCommand.cs

Asynchronní verze ExecuteReader(), která odešle CommandText do Connection a vytvoří SqlDataReader. Token zrušení lze použít k vyžádání, aby byla operace zruš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::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

Jiný SqlDbType než Binary nebo VarBinary byl použit při Value nastavení Stream. Další informace o streamování najdete v tématu Podpora streamování SqlClient.
Jiný SqlDbType než Char, , NChar, NVarCharVarCharnebo Xml byl použit při Value nastavení TextReader.
Jiné SqlDbType , než Xml bylo použito při Value nastavení XmlReader.

ArgumentException

Neplatná CommandBehavior hodnota.

InvalidOperationException

Volání ExecuteReaderAsync(CommandBehavior, CancellationToken) více než jednou pro stejnou instanci před dokončením úkolu
Zavřený SqlConnection nebo ukončený 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.
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 k chybě nebo Stream XmlReader TextReader objektu. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

ObjectDisposedException

Stream Objekt XmlReadernebo TextReader objekt 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ředkovatel dat .NET Framework pro SQL Server naleznete v tématu Synchronous Programming.

Platí pro

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Zdroj:: SqlCommand.cs

Zdroj:: SqlCommand.cs

Zdroj:: SqlCommand.cs

Zdroj:: SqlCommand.cs

Asynchronní verze ExecuteReader(CommandBehavior), která odešle CommandText do Connectiona sestavení SqlDataReader tokenu zrušení lze použít k vyžádání, aby operace byla opuštěna 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 spouštění příkazů a načítání dat Pokud je nastavená hodnota Default, ReadAsync(CancellationToken) přečte 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

Jiný SqlDbType než Binary nebo VarBinary byl použit při Value nastavení Stream. Další informace o streamování najdete v tématu Podpora streamování SqlClient.
Jiný SqlDbType než Char, , NChar, NVarCharVarCharnebo Xml byl použit při Value nastavení TextReader.
Jiné SqlDbType , než Xml bylo použito při Value nastavení XmlReader.

ArgumentException

Neplatná CommandBehavior hodnota.

InvalidOperationException

Volání ExecuteReaderAsync(CommandBehavior, CancellationToken) více než jednou pro stejnou instanci před dokončením úkolu
Zavřený SqlConnection nebo ukončený 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.
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 k chybě nebo Stream XmlReader TextReader objektu. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

ObjectDisposedException

Stream Objekt XmlReadernebo TextReader objekt 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ředkovatel dat .NET Framework pro SQL Server naleznete v tématu Synchronous Programming.

Platí pro