SqlCommand.EndExecuteXmlReader Method

Finishes asynchronous execution of a Transact-SQL statement, returning the requested data as XML.

Namespace: System.Data.SqlClient
Assembly: System.Data (in system.data.dll)

public XmlReader EndExecuteXmlReader (
	IAsyncResult asyncResult
public XmlReader EndExecuteXmlReader (
	IAsyncResult asyncResult
public function EndExecuteXmlReader (
	asyncResult : IAsyncResult
) : XmlReader
Not applicable.



The IAsyncResult returned by the call to BeginExecuteXmlReader.

Return Value

An XmlReader object that can be used to fetch the resulting XML data.

Exception typeCondition


asyncResult parameter is null (Nothing in Microsoft Visual Basic)


EndExecuteXmlReader was called more than once for a single command execution, or the method was mismatched against its execution method (for example, the code called EndExecuteXmlReader to complete execution of a call to BeginExecuteNonQuery.

When you call BeginExecuteXmlReader to execute a Transact-SQL statement, you must call EndExecuteXmlReader in order to complete the operation. If the process of executing the command has not yet finished, this method blocks until the operation is complete. Users can verify that the command has completed its operation by using the IAsyncResult instance returned by the BeginExecuteXmlReader method. If a callback procedure was specified in the call to BeginExecuteXmlReader, this method must be called.

For examples demonstrating the use of the EndExecuteXmlReader method, see BeginExecuteXmlReader.

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions