Méthode Worksheet.XmlMapQuery (Excel)

  • Article

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.