SqlCommand.EndExecuteXmlReader(IAsyncResult) Méthode

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

Termine l'exécution asynchrone d'une instruction Transact-SQL en retournant les données demandées en 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

Paramètres

asyncResult

IAsyncResult

IAsyncResult retourné par l’appel à BeginExecuteXmlReader() .

Retours

XmlReader

Objet XmlReader qui peut être utilisé pour récupérer les données XML résultantes.

Exceptions

ArgumentException

asyncResult le paramètre a la valeur null ( Nothing dans Microsoft Visual Basic)

InvalidOperationException

EndExecuteXmlReader(IAsyncResult) a été appelé plusieurs fois pour une exécution de commande unique, ou la méthode n’a pas été incompatible avec sa méthode d’exécution (par exemple, le code appelé EndExecuteXmlReader(IAsyncResult) pour terminer l’exécution d’un appel à BeginExecuteNonQuery() .

Exemples

Pour obtenir des exemples illustrant l’utilisation de la EndExecuteXmlReader méthode, consultez BeginExecuteXmlReader.

Remarques

Lorsque vous appelez BeginExecuteXmlReader pour exécuter une instruction Transact-SQL, vous devez appeler EndExecuteXmlReader pour terminer l’opération. Si le processus d’exécution de la commande n’est pas encore terminé, cette méthode se bloque jusqu’à ce que l’opération soit terminée. Les utilisateurs peuvent vérifier que la commande a terminé son opération à l’aide de l’instance IAsyncResult retournée par la BeginExecuteXmlReader méthode . Si une procédure de rappel a été spécifiée dans l’appel à BeginExecuteXmlReader, cette méthode doit être appelée.