SqlCommand.ExecuteXmlReaderAsync Metoda

Definice

Obor názvů:

System.Data.SqlClient

Sestavení:

System.Data.SqlClient.dll

Balíček:

System.Data.SqlClient v4.8.6

Zahájí asynchronní spuštění příkazu Transact-SQL nebo uložené procedury, která je popsána tímto SqlCommand a vrátí výsledky jako XmlReader objekt.

Přetížení

ExecuteXmlReaderAsync()	Asynchronní verze nástroje ExecuteXmlReader(), která odešle CommandText objektu Connection a vytvoří XmlReader objekt. Výjimky budou hlášeny prostřednictvím vráceného objektu Task.
ExecuteXmlReaderAsync(CancellationToken)	Asynchronní verze nástroje ExecuteXmlReader(), která odešle CommandText objektu Connection a vytvoří XmlReader objekt. 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.

ExecuteXmlReaderAsync()

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

Výjimky budou hlášeny prostřednictvím vráceného objektu Task.

public:
 System::Threading::Tasks::Task<System::Xml::XmlReader ^> ^ ExecuteXmlReaderAsync();

public System.Threading.Tasks.Task<System.Xml.XmlReader> ExecuteXmlReaderAsync ();

member this.ExecuteXmlReaderAsync : unit -> System.Threading.Tasks.Task<System.Xml.XmlReader>

Public Function ExecuteXmlReaderAsync () As Task(Of XmlReader)

Návraty

Task<XmlReader>

Úloha představující asynchronní operaci

Výjimky

InvalidCastException

Při SqlDbType nastavení na Streamhodnotu 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 TextReaderhodnotu se použila Value jiná hodnota než Char, NChar, NVarChar, VarChar nebo XML.

-nebo-

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

InvalidOperationException

Volání ExecuteScalarAsync(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.

-nebo-

Context Connection=trueje zadáno 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 v objektu Streamnebo TextReaderXmlReader k chybě. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

ObjectDisposedException

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

Poznámky

XmlReader vrácená touto metodou nepodporuje asynchronní operace.

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

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem ExecuteXmlReader().

Viz také

• Přehled ADO.NET

ExecuteXmlReaderAsync(CancellationToken)

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

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<System::Xml::XmlReader ^> ^ ExecuteXmlReaderAsync(System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Xml.XmlReader> ExecuteXmlReaderAsync (System.Threading.CancellationToken cancellationToken);

member this.ExecuteXmlReaderAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Xml.XmlReader>

Public Function ExecuteXmlReaderAsync (cancellationToken As CancellationToken) As Task(Of XmlReader)

Parametry

cancellationToken

CancellationToken

Instrukce zrušení

Návraty

Task<XmlReader>

Úloha představující asynchronní operaci

Výjimky

InvalidCastException

Při SqlDbType nastavení na Streamhodnotu 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 TextReaderhodnotu se použila Value jiná hodnota než Char, NChar, NVarChar, VarChar nebo XML.

-nebo-

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

InvalidOperationException

Volání ExecuteScalarAsync(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.

-nebo-

Context Connection=trueje zadáno 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 v objektu Streamnebo TextReaderXmlReader k chybě. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

ObjectDisposedException

Objekt Streamnebo XmlReaderTextReader 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 ve vrácené úloze.

Poznámky

XmlReader vrácená touto metodou nepodporuje asynchronní operace.

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

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem ExecuteXmlReader().

Viz také

• Přehled ADO.NET