.ExecuteXmlReaderAsync Method (CancellationToken)
An asynchronous version of
, which sends the ExecuteXmlReader to the CommandText and builds an Connection object. XmlReader
The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object.
public Task<XmlReader> ExecuteXmlReaderAsync(
Exception Condition InvalidCastException
other than SqlDbType Binary or VarBinary was used when was set to Value . For more information about streaming, see Stream . SqlClient Streaming Support
other than SqlDbType Char, NChar, NVarChar, VarChar, or Xml was used when was set to Value . TextReader
other than SqlDbType Xml was used when was set to Value . XmlReader InvalidOperationException
more than once for the same instance before task completion. ExecuteScalarAsync
closed or dropped during a streaming operation. For more information about streaming, see SqlConnection . SqlClient Streaming Support is specified in the connection string. Context Connection=true SqlException
SQL Server returned an error while executing the command text.
A timeout occurred during a streaming operation. For more information about streaming, see
. SqlClient Streaming Support IOException
An error occurred in a
, Stream or XmlReader object during a streaming operation. For more information about streaming, see TextReader . SqlClient Streaming Support ObjectDisposedException
, Stream or XmlReader object was closed during a streaming operation. For more information about streaming, see TextReader . SqlClient Streaming Support
For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see
. Asynchronous Programming .NET Framework
Supported in: 4.6, 4.5
Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.