SqlCommand.ExecuteXmlReaderAsync 方法

定义

命名空间:

System.Data.SqlClient

程序集:

System.Data.SqlClient.dll

包:

System.Data.SqlClient v4.9.0

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

重载

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

ExecuteXmlReaderAsync()

Source:

System.Data.SqlClient.notsupported.cs

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)

Source:

System.Data.SqlClient.notsupported.cs

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 概述