SqlCommand.ExecuteXmlReaderAsync Metoda

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

Přetížení

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

ExecuteXmlReaderAsync()

Asynchronní verze nástroje ExecuteXmlReader() , která odesílá CommandText objekt do objektu Connection a sestaví 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 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 se použila Value jiná hodnota než XML.

InvalidOperationException

Volání ExecuteScalarAsync(CancellationToken) více než jednou pro stejnou instanci před dokončením úlohy.

-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 při provádění textu příkazu vrátil chybu.

-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 zavř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í ve 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í ExecuteXmlReader 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 .

ExecuteXmlReaderAsync(CancellationToken)

Asynchronní verze nástroje ExecuteXmlReader() , která odesílá CommandText objekt do objektu Connection a sestaví XmlReader objekt.

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::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 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 se použila Value jiná hodnota než XML.

InvalidOperationException

Volání ExecuteScalarAsync(CancellationToken) více než jednou pro stejnou instanci před dokončením úlohy.

-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 při provádění textu příkazu vrátil chybu.

-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 zavř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í ve zprostředkovateli dat rozhraní .NET Framework pro SQL Server najdete v tématu Asynchronní programování.