SqlCommand.EndExecuteXmlReader(IAsyncResult) Metoda

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

Kończy asynchroniczne wykonywanie instrukcji Języka Transact-SQL, zwracając żądane dane jako 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

Parametry

asyncResult

IAsyncResult

Element IAsyncResult zwrócony przez wywołanie metody BeginExecuteXmlReader() .

Zwraca

XmlReader

Obiekt XmlReader , który może służyć do pobierania wynikowych danych XML.

Wyjątki

ArgumentException

asyncResult parametr ma wartość null ( Nothing w języku Microsoft Visual Basic)

InvalidOperationException

EndExecuteXmlReader(IAsyncResult) była wywoływana więcej niż raz dla pojedynczego wykonania polecenia lub metoda została niezgodna z jej metodą wykonywania (na przykład kod wywoływany EndExecuteXmlReader(IAsyncResult) w celu ukończenia wykonywania wywołania metody BeginExecuteNonQuery() .

Przykłady

Przykłady pokazujące użycie EndExecuteXmlReader metody można znaleźć w temacie BeginExecuteXmlReader.

Uwagi

Wywołanie metody BeginExecuteXmlReader w celu wykonania instrukcji Języka Transact-SQL wymaga wywołania EndExecuteXmlReader w celu ukończenia operacji. Jeśli proces wykonywania polecenia nie został jeszcze zakończony, ta metoda blokuje działanie do czasu ukończenia operacji. Użytkownicy mogą sprawdzić, czy polecenie zakończyło operację, używając IAsyncResult wystąpienia zwróconego przez metodę BeginExecuteXmlReader . Jeśli w wywołaniu metody BeginExecuteXmlReaderokreślono procedurę wywołania zwrotnego , należy wywołać tę metodę.