SqlCommand.ExecuteXmlReaderAsync Metoda

Definice

Inicializuje asynchronní spuštění příkazu jazyka Transact-SQL nebo uložené procedury, která je popsána tímto SqlCommand a vrátí výsledky jako XmlReader objekt.Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this SqlCommand and returns results as an XmlReader object.

Přetížení

ExecuteXmlReaderAsync()

Asynchronní verze nástroje ExecuteXmlReader() , která odesílá CommandText do Connection a vytvoří XmlReader objekt.An asynchronous version of ExecuteXmlReader(), which sends the CommandText to the Connection and builds an XmlReader object.

Výjimky budou hlášeny prostřednictvím vráceného objektu Task.Exceptions will be reported via the returned Task object.

ExecuteXmlReaderAsync(CancellationToken)

Asynchronní verze nástroje ExecuteXmlReader() , která odesílá CommandText do Connection a vytvoří XmlReader objekt.An asynchronous version of ExecuteXmlReader(), which sends the CommandText to the Connection and builds an XmlReader object.

Token zrušení lze použít k vyžádání, že operace bude opuštěna před uplynutím časového limitu příkazu.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Výjimky budou hlášeny prostřednictvím vráceného objektu Task.Exceptions will be reported via the returned Task object.

ExecuteXmlReaderAsync()

Asynchronní verze nástroje ExecuteXmlReader() , která odesílá CommandText do Connection a vytvoří XmlReader objekt.An asynchronous version of ExecuteXmlReader(), which sends the CommandText to the Connection and builds an XmlReader object.

Výjimky budou hlášeny prostřednictvím vráceného objektu Task.Exceptions will be reported via the returned Task object.

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í operaciA task representing the asynchronous operation.

Výjimky

V SqlDbType případě, že Value byl nastaven na hodnotu, byl použit jiný než binární nebo varbinary Stream .A SqlDbType other than Binary or VarBinary was used when Value was set to Stream. Další informace o streamování najdete v článku Podpora pro streamování SqlClient.For more information about streaming, see SqlClient Streaming Support.

-nebo--or-

V SqlDbType případě, že byl nastaven na hodnotu, byl použit jiný než char, nchar, nvarchar, varchar nebo XML Value TextReader .A SqlDbType other than Char, NChar, NVarChar, VarChar, or Xml was used when Value was set to TextReader.

-nebo--or-

V SqlDbType případě, že Value byl nastaven na hodnotu, byl použit jiný než kód XML XmlReader .A SqlDbType other than Xml was used when Value was set to XmlReader.

Volání ExecuteScalarAsync(CancellationToken) více než jednou pro stejnou instanci před dokončením úkolu.Calling ExecuteScalarAsync(CancellationToken) more than once for the same instance before task completion.

-nebo--or-

SqlConnectionUzavřeno nebo vynecháno během operace streamování.The SqlConnection closed or dropped during a streaming operation. Další informace o streamování najdete v článku Podpora pro streamování SqlClient.For more information about streaming, see SqlClient Streaming Support.

-nebo--or-

Context Connection=true je zadáno v připojovacím řetězci.Context Connection=true is specified in the connection string.

Při provádění textu příkazu vrátila SQL Server chybu.SQL Server returned an error while executing the command text.

-nebo--or-

Během operace streamování došlo k vypršení časového limitu.A timeout occurred during a streaming operation. Další informace o streamování najdete v článku Podpora pro streamování SqlClient.For more information about streaming, see SqlClient Streaming Support.

Došlo k chybě v Stream XmlReader TextReader objektu nebo během operace streamování.An error occurred in a Stream, XmlReader or TextReader object during a streaming operation. Další informace o streamování najdete v článku Podpora pro streamování SqlClient.For more information about streaming, see SqlClient Streaming Support.

Stream XmlReader TextReader Objekt nebo byl během operace streamování uzavřen.The Stream, XmlReader or TextReader object was closed during a streaming operation. Další informace o streamování najdete v článku Podpora pro streamování SqlClient.For more information about streaming, see SqlClient Streaming Support.

Poznámky

Objekt XmlReader vrácený touto metodou nepodporuje asynchronní operace.The XmlReader returned by this method does not support asynchronous operations.

Další informace o asynchronním programování v .NET Framework Zprostředkovatel dat pro SQL Server naleznete v tématu Asynchronous Programming.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

Platí pro

ExecuteXmlReaderAsync(CancellationToken)

Asynchronní verze nástroje ExecuteXmlReader() , která odesílá CommandText do Connection a vytvoří XmlReader objekt.An asynchronous version of ExecuteXmlReader(), which sends the CommandText to the Connection and builds an XmlReader object.

Token zrušení lze použít k vyžádání, že operace bude opuštěna před uplynutím časového limitu příkazu.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Výjimky budou hlášeny prostřednictvím vráceného objektu Task.Exceptions will be reported via the returned Task object.

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íThe cancellation instruction.

Návraty

Task<XmlReader>

Úloha představující asynchronní operaciA task representing the asynchronous operation.

Výjimky

V SqlDbType případě, že Value byl nastaven na hodnotu, byl použit jiný než binární nebo varbinary Stream .A SqlDbType other than Binary or VarBinary was used when Value was set to Stream. Další informace o streamování najdete v článku Podpora pro streamování SqlClient.For more information about streaming, see SqlClient Streaming Support.

-nebo--or-

V SqlDbType případě, že byl nastaven na hodnotu, byl použit jiný než char, nchar, nvarchar, varchar nebo XML Value TextReader .A SqlDbType other than Char, NChar, NVarChar, VarChar, or Xml was used when Value was set to TextReader.

-nebo--or-

V SqlDbType případě, že Value byl nastaven na hodnotu, byl použit jiný než kód XML XmlReader .A SqlDbType other than Xml was used when Value was set to XmlReader.

Volání ExecuteScalarAsync(CancellationToken) více než jednou pro stejnou instanci před dokončením úkolu.Calling ExecuteScalarAsync(CancellationToken) more than once for the same instance before task completion.

-nebo--or-

SqlConnectionUzavřeno nebo vynecháno během operace streamování.The SqlConnection closed or dropped during a streaming operation. Další informace o streamování najdete v článku Podpora pro streamování SqlClient.For more information about streaming, see SqlClient Streaming Support.

-nebo--or-

Context Connection=true je zadáno v připojovacím řetězci.Context Connection=true is specified in the connection string.

Při provádění textu příkazu vrátila SQL Server chybu.SQL Server returned an error while executing the command text.

-nebo--or-

Během operace streamování došlo k vypršení časového limitu.A timeout occurred during a streaming operation. Další informace o streamování najdete v článku Podpora pro streamování SqlClient.For more information about streaming, see SqlClient Streaming Support.

Došlo k chybě v Stream XmlReader TextReader objektu nebo během operace streamování.An error occurred in a Stream, XmlReader or TextReader object during a streaming operation. Další informace o streamování najdete v článku Podpora pro streamování SqlClient.For more information about streaming, see SqlClient Streaming Support.

Stream XmlReader TextReader Objekt nebo byl během operace streamování uzavřen.The Stream, XmlReader or TextReader object was closed during a streaming operation. Další informace o streamování najdete v článku Podpora pro streamování SqlClient.For more information about streaming, see SqlClient Streaming Support.

Poznámky

Objekt XmlReader vrácený touto metodou nepodporuje asynchronní operace.The XmlReader returned by this method does not support asynchronous operations.

Další informace o asynchronním programování v .NET Framework Zprostředkovatel dat pro SQL Server naleznete v tématu Asynchronous Programming.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

Platí pro