SqlCommand.ExecuteXmlReaderAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
启动由此描述 SqlCommand 的 Transact-SQL 语句或存储过程的异步执行，并将结果作为对象 XmlReader 返回。
重载
| 名称 | 说明 |
|---|---|
| ExecuteXmlReaderAsync() |
一个异步版本ExecuteXmlReader()，用于将对象发送到CommandTextConnection并生成对象XmlReader。 异常将通过返回的任务对象报告。 |
| ExecuteXmlReaderAsync(CancellationToken) |
一个异步版本ExecuteXmlReader()，用于将对象发送到CommandTextConnection并生成对象XmlReader。 取消令牌可用于请求在命令超时之前放弃操作。 异常将通过返回的任务对象报告。 |
ExecuteXmlReaderAsync()
一个异步版本ExecuteXmlReader()，用于将对象发送到CommandTextConnection并生成对象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)返回
表示异步操作的任务。
例外
如果设置为 SqlDbType，则使用二进制或 Value 以外的其他Stream项。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
-或-
设置为
-或-
在任务完成前多次为同一实例调用 ExecuteScalarAsync(CancellationToken) 一次。
-或-
在 SqlConnection 流式处理操作期间关闭或删除。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
-或-
Context Connection=true在连接字符串中指定。
流式处理操作期间发生错误StreamXmlReader或TextReader对象。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
Stream XmlReader流式处理操作期间关闭或TextReader对象。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
注解
此方法返回的 XmlReader 不支持异步操作。
有关 .NET Framework Data Provider 中用于SQL Server的异步编程的详细信息，请参阅 Asynchronous Programming。
此方法存储在任务中，它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中，则等待任务时将引发该异常。 使用情况异常（例如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅由 ExecuteXmlReader()..
另请参阅
适用于
ExecuteXmlReaderAsync(CancellationToken)
一个异步版本ExecuteXmlReader()，用于将对象发送到CommandTextConnection并生成对象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
取消指令。
返回
表示异步操作的任务。
例外
如果设置为 SqlDbType，则使用二进制或 Value 以外的其他Stream项。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
-或-
设置为
-或-
在任务完成前多次为同一实例调用 ExecuteScalarAsync(CancellationToken) 一次。
-或-
在 SqlConnection 流式处理操作期间关闭或删除。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
-或-
Context Connection=true在连接字符串中指定。
流式处理操作期间发生错误StreamXmlReader或TextReader对象。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
Stream XmlReader流式处理操作期间关闭或TextReader对象。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
取消令牌已取消。 此异常存储在返回的任务中。
注解
此方法返回的 XmlReader 不支持异步操作。
有关 .NET Framework Data Provider 中用于SQL Server的异步编程的详细信息，请参阅 Asynchronous Programming。
此方法存储在任务中，它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中，则等待任务时将引发该异常。 使用情况异常（例如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅由 ExecuteXmlReader()..