Méthode Worksheet.XmlDataQuery (Excel)

Renvoie un objet Range qui représente les cellules mappées à un XPath particulier. Elle renvoie la valeur Nothing si l'objet XPath spécifié n'a pas été mappé sur la feuille de calcul, ou si la plage mappée est vide.

Syntaxe

expression. XmlDataQuery (XPath, SelectionNamespaces, Map)

expression Variable qui représente un objet Feuille de calcul.

Parameters

Nom Requis/Facultatif Type de données Description
XPath Obligatoire String L'objet XPath de la requête.
SelectionNamespaces Facultatif Variant Type de données String délimitée par des espaces contenant les espaces de noms référencés dans le paramètre XPath. Une erreur d’exécution est générée si l’un des espaces de noms spécifiés ne peut pas être résolu.
Map Facultatif Variant Spécifiez un XmlMap si vous souhaitez interroger le XPath dans un mappage spécifique.

Valeur renvoyée

Range

Remarques

Si l'objet XPath existe dans une colonne de liste XML, l'objet Range renvoyé ne comprend ni la ligne d'en-tête ni la ligne d'insertion.

Cette méthode renvoie Nothing si le chemin d'accès de l'objet XPath n'est pas mappé dans la grille. Ainsi, si la valeur Nothing est renvoyée, cela ne signifie pas nécessairement que le mappage n'existe pas. Cela peut signifier qu'il n'existe actuellement pas de plage de données disponible à l'emplacement XPath spécifié. Utilisez la méthode XmlMapQuery pour vérifier l’existence d’un XPath mappé.

Remarque

La méthode XmlDataQuery vous permet de créer une requête pour vérifier l'existence d'une données de mappage particulière. Il ne peut pas être utilisé pour interroger un élément de données dans une carte.

Par exemple, il est valide pour qu’une plage mappée existe dans laquelle le XPath de cette plage est "/root/People[@Age="23"]/FirstName". Une requête XmlDataQuery pour ce chemin d’emplacement XPath retourne la plage correcte. Toutefois, une requête pour "/root/People[FirstName="Joe"]" espérer trouver « Joe » dans la plage mappée ci-dessus échoue, car les définitions XPath des plages mappées sont différentes.

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.