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.