Méthode Worksheet.XmlMapQuery (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.
Syntaxe
expression. XmlMapQuery (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écifie un mappage XML comme cible d'une requête de XPath. |
Valeur renvoyée
Range
Remarques
Contrairement à la méthode XmlDataQuery , la méthode XmlMapQuery retourne la colonne entière d’une liste XML, y compris la ligne d’en-tête.
Remarque
XmlMapQuery permet aux développeurs d’interroger l’existence de mappages particuliers. 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"
. Un appel XmlMapQuery pour ce XPath retourne la plage correcte. Toutefois, une requête pour "/root/People[FirstName="Joe"]"
s’attendre à 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.