SqlCommand.ExecuteXmlReaderAsync 方法

定义

命名空间:

System.Data.SqlClient

程序集:

System.Data.SqlClient.dll

包:

System.Data.SqlClient v4.8.6

启动此 SqlCommand 描述的 Transact-SQL 语句或存储过程的异步执行，并将结果作为 XmlReader 对象返回。

重载

ExecuteXmlReaderAsync()	ExecuteXmlReader() 的异步版本，可以将 CommandText 发送到 Connection，并生成 XmlReader 对象。 将通过返回的任务对象报告异常。
ExecuteXmlReaderAsync(CancellationToken)	ExecuteXmlReader() 的异步版本，可以将 CommandText 发送到 Connection，并生成 XmlReader 对象。 取消标记可用于在命令超时超过前请求放弃操作。 将通过返回的任务对象报告异常。

ExecuteXmlReaderAsync()

ExecuteXmlReader() 的异步版本，可以将 CommandText 发送到 Connection，并生成 XmlReader 对象。

将通过返回的任务对象报告异常。

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)

返回

Task<XmlReader>

表示异步操作的任务。

例外

InvalidCastException

将 Value 设置为 Stream 时，使用的是 SqlDbType 而不是 Binary 或 VarBinary。 有关流式处理的详细信息，请参阅 SqlClient 流支持。

- 或 -

设置为 SqlDbType 时ValueTextReader，使用了 Char、NChar、NVarChar、VarChar 或 Xml 以外的 。

- 或 -

将 Value 设置为 XmlReader 时，使用的是 SqlDbType 而不是 Xml。

InvalidOperationException

在完成任务前，为同一个实例多次调用 ExecuteScalarAsync(CancellationToken)。

- 或 -

流式处理操作期间关闭或删除了 SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient 流支持。

- 或 -

在连接字符串中指定 Context Connection=true。

SqlException

执行命令文本时，SQL Server 返回了一个错误。

- 或 -

流式处理操作期间发生了超时。 有关流式处理的详细信息，请参阅 SqlClient 流支持。

IOException

流式处理操作期间在 Stream、XmlReader 或 TextReader 对象中出现了错误。 有关流式处理的详细信息，请参阅 SqlClient 流支持。

ObjectDisposedException

流式处理操作期间关闭了 Stream、XmlReader 或 TextReader 对象。 有关流式处理的详细信息，请参阅 SqlClient 流支持。

注解

此方法返回的 XmlReader 不支持异步操作。

有关 .NET Framework Data Provider for SQL Server 中异步编程的详细信息，请参阅异步编程。

此方法将存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 ExecuteXmlReader()异常。

另请参阅

• ADO.NET 概述

ExecuteXmlReaderAsync(CancellationToken)

ExecuteXmlReader() 的异步版本，可以将 CommandText 发送到 Connection，并生成 XmlReader 对象。

取消标记可用于在命令超时超过前请求放弃操作。 将通过返回的任务对象报告异常。

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)

参数

cancellationToken

CancellationToken

取消指示。

返回

Task<XmlReader>

表示异步操作的任务。

例外

InvalidCastException

将 Value 设置为 Stream 时，使用的是 SqlDbType 而不是 Binary 或 VarBinary。 有关流式处理的详细信息，请参阅 SqlClient 流支持。

- 或 -

设置为 SqlDbType 时ValueTextReader，使用了 Char、NChar、NVarChar、VarChar 或 Xml 以外的 。

- 或 -

将 Value 设置为 XmlReader 时，使用的是 SqlDbType 而不是 Xml。

InvalidOperationException

在完成任务前，为同一个实例多次调用 ExecuteScalarAsync(CancellationToken)。

- 或 -

流式处理操作期间关闭或删除了 SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient 流支持。

- 或 -

在连接字符串中指定 Context Connection=true。

SqlException

执行命令文本时，SQL Server 返回了一个错误。

- 或 -

流式处理操作期间发生了超时。 有关流式处理的详细信息，请参阅 SqlClient 流支持。

IOException

流式处理操作期间在 Stream、XmlReader 或 TextReader 对象中出现了错误。 有关流式处理的详细信息，请参阅 SqlClient 流支持。

ObjectDisposedException

流式处理操作期间关闭了 Stream、XmlReader 或 TextReader 对象。 有关流式处理的详细信息，请参阅 SqlClient 流支持。

OperationCanceledException

取消令牌已取消。 此异常存储在返回的任务中。

注解

此方法返回的 XmlReader 不支持异步操作。

有关 .NET Framework Data Provider for SQL Server 中异步编程的详细信息，请参阅异步编程。

此方法将存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 ExecuteXmlReader()异常。

另请参阅

• ADO.NET 概述