SqlCommand.EndExecuteXmlReader(IAsyncResult) Methode

Definition

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Beendet die asynchrone Ausführung einer Transact-SQL-Anweisung, und gibt die angeforderten Daten als XML zurück.

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

Parameter

asyncResult

IAsyncResult

Die IAsyncResult , die vom Aufruf BeginExecuteXmlReader() von zurückgegeben wird.

Gibt zurück

XmlReader

Ein XmlReader-Objekt, mit dem die resultierenden XML-Daten abgefragt werden können.

Ausnahmen

ArgumentException

asyncResult Parameter ist NULL ( Nothing in Microsoft Visual Basic)

InvalidOperationException

EndExecuteXmlReader(IAsyncResult) wurde mehr als einmal für eine einzelne Befehlsausführung aufgerufen, oder die Methode wurde mit ihrer Ausführungsmethode nicht übereinstimmen (z. B. der Code, der aufgerufen wurde EndExecuteXmlReader(IAsyncResult) , um die Ausführung eines Aufrufs von abzuschließen BeginExecuteNonQuery() .

Beispiele

Beispiele für die Verwendung der EndExecuteXmlReader -Methode finden Sie unter BeginExecuteXmlReader.

Hinweise

Wenn Sie aufrufen BeginExecuteXmlReader , um eine Transact-SQL-Anweisung auszuführen, müssen Sie aufrufen EndExecuteXmlReader , um den Vorgang abzuschließen. Wenn der Prozess der Ausführung des Befehls noch nicht abgeschlossen ist, wird diese Methode blockiert, bis der Vorgang abgeschlossen ist. Benutzer können mithilfe der von der -Methode zurückgegebenen Instanz überprüfen, ob der IAsyncResultBeginExecuteXmlReader Befehl seinen Vorgang abgeschlossen hat. Wenn im Aufruf von BeginExecuteXmlReadereine Rückrufprozedur angegeben wurde, muss diese Methode aufgerufen werden.