SqlCommand.ExecuteReaderAsync Metoda

Definice

Obor názvů:

System.Data.SqlClient

Sestavení:

System.Data.dll

Iniciuje asynchronní spuštění příkazu Transact-SQL nebo uložené procedury, která je popsána tímto SqlCommand.

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 na Connection, a sestavení 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.

Poznámky

Další informace o asynchronním programování v Zprostředkovatel dat .NET Framework pro SQL Server naleznete v tématu Synchronous Programming.

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.

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)

Návraty

Task<SqlDataReader>

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

Výjimky

InvalidCastException

SqlDbType Jiný 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.

nebo

SqlDbType Jiná hodnota než Char, NChar, NVarChar, VarChar nebo Xml byla použita při Value nastavení TextReader.

nebo

SqlDbType Jiná než Xml byla použita při Value nastavení na XmlReaderhodnotu .

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 ukončený během operace streamování. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

nebo

Context Connection=true je zadán v připojovací řetězec.

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 k chybě nebo StreamXmlReaderTextReader 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.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané ExecuteReader().

Viz také

• Přehled ADO.NET

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.

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)

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

SqlDbType Jiný 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.

nebo

SqlDbType Jiná hodnota než Char, NChar, NVarChar, VarChar nebo Xml byla použita při Value nastavení TextReader.

nebo

SqlDbType Jiná než Xml byla použita při Value nastavení na XmlReaderhodnotu .

ArgumentException

Neplatná CommandBehavior hodnota.

InvalidOperationException

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

nebo

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

nebo

Context Connection=true je zadán v připojovací řetězec.

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 k chybě nebo StreamXmlReaderTextReader 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.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané ExecuteReader(CommandBehavior).

Viz také

• Přehled ADO.NET

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.

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)

Parametry

cancellationToken

CancellationToken

Instrukce zrušení.

Návraty

Task<SqlDataReader>

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

Výjimky

InvalidCastException

SqlDbType Jiný 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.

nebo

SqlDbType Jiná hodnota než Char, NChar, NVarChar, VarChar nebo Xml byla použita při Value nastavení TextReader.

nebo

SqlDbType Jiná než Xml byla použita při Value nastavení na XmlReaderhodnotu .

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 ukončený během operace streamování. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

nebo

Context Connection=true je zadán v připojovací řetězec.

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 k chybě nebo StreamXmlReaderTextReader 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.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena do vrácené úlohy.

Poznámky

Další informace o asynchronním programování v Zprostředkovatel dat .NET Framework pro SQL Server naleznete v tématu Synchronous Programming.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané ExecuteReader().

Viz také

• Přehled ADO.NET

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Asynchronní verze ExecuteReader(CommandBehavior), která odešle CommandText na Connection, a sestavení 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<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)

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

SqlDbType Jiný 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.

nebo

SqlDbType Jiná hodnota než Char, NChar, NVarChar, VarChar nebo Xml byla použita při Value nastavení TextReader.

nebo

SqlDbType Jiná než Xml byla použita při Value nastavení na XmlReaderhodnotu .

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 ukončený během operace streamování. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

nebo

Context Connection=true je zadán v připojovací řetězec.

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 k chybě nebo StreamXmlReaderTextReader 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.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena do vrácené úlohy.

Poznámky

Další informace o asynchronním programování v Zprostředkovatel dat .NET Framework pro SQL Server naleznete v tématu Synchronous Programming.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané ExecuteReader(CommandBehavior).

Viz také

• Přehled ADO.NET