SqlCommand.EndExecuteXmlReader(IAsyncResult) 方法

定义

命名空间:

Microsoft.Data.SqlClient

程序集:

Microsoft.Data.SqlClient.dll

包:

Microsoft.Data.SqlClient v5.2.0

完成 Transact-SQL 语句的异步执行，从而将请求的数据以 XML 形式返回。

public:
 System::Xml::XmlReader ^ EndExecuteXmlReader(IAsyncResult ^ asyncResult);

public System.Xml.XmlReader EndExecuteXmlReader (IAsyncResult asyncResult);

member this.EndExecuteXmlReader : IAsyncResult -> System.Xml.XmlReader

Public Function EndExecuteXmlReader (asyncResult As IAsyncResult) As XmlReader

参数

asyncResult

IAsyncResult

IAsyncResult调用 返回的 BeginExecuteXmlReader() 。

返回

XmlReader

可用于提取生成的 XML 数据的 XmlReader 对象。

例外

ArgumentException

asyncResult microsoft Visual Basic) Nothing 中的参数为 null (

InvalidOperationException

EndExecuteXmlReader(IAsyncResult) 为单个命令执行多次调用，或者方法与其执行方法不匹配 (例如，调用 EndExecuteXmlReader(IAsyncResult) 的代码以完成对 BeginExecuteNonQuery() 的调用的执行。

示例

有关演示如何使用 EndExecuteXmlReader 方法的示例，请参阅 BeginExecuteXmlReader。

注解

调用 BeginExecuteXmlReader 以执行 Transact-SQL 语句时，必须调用 EndExecuteXmlReader 才能完成操作。 如果命令的执行过程尚未完成，则此方法将阻止，直到操作完成。 用户可以使用 方法返回BeginExecuteXmlReader的 实例来验证命令是否已完成其操作IAsyncResult。 如果在调用 BeginExecuteXmlReader中指定了回调过程，则必须调用此方法。