Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais

Collections XPath

Les collections retournées par des requêtes XPath conservent l'ordre, la hiérarchie et l'identité des documents, dans la mesure où ceux-ci sont définis. En d'autres termes, une collection d'éléments est retournée dans l'ordre du document, sans répétition d'éléments. Puisque, par définition, les attributs ne sont pas ordonnés, aucun ordre implicite n'existe dans les attributs retournés pour un élément spécifique.

La collection de tous les éléments ayant un certain nom de balise est exprimée par le nom même de la balise. On peut qualifier cela en montrant que les éléments sont sélectionnés dans le contexte actuel à l'aide d'un point et d'une barre oblique (./), mais le contexte actuel est utilisé par défaut et ne doit donc pas être noté explicitement.

Expression

Référence

./first-name

Tous les éléments <first-name>. Notez que cette expression est équivalente à l'expression qui suit.

first-name

Tous les éléments <first-name>.

Les expressions XPath facilitent l'interrogation d'un nœud spécifique dans une collection de nœuds. Il suffit d'inclure l'ordinal de l'index entre des crochets. Cet ordinal est de base 1 (le premier élément est le numéro 1).

Les caractères entre crochets ([]) ont une priorité supérieure à celle des caractères entre barres obliques (/ et //). Pour plus d'informations, consultez Opérateurs et caractères spéciaux

ms256090.collapse_all(fr-fr,VS.120).gifExemples

Expression

Référence

author[1]

Premier élément <author>.

author[first-name][3]

Troisième élément <author> ayant un élément enfant <first-name>.

Notez que les index sont relatifs à l'ensemble soumis au filtre. Considérez par exemple les données suivantes.

<x>
  <y/>
  <y/>
</x>
<x>
  <y/>
  <y/>
</x>

Le tableau suivant indique comment sélectionner des éléments <x> et <y> spécifiques.

Expression

Référence

x/y[1]

Premier <y> à l'intérieur de chaque <x>.

(x/y)[1]

Premier <y> de tout l'ensemble d'éléments <y> à l'intérieur d'éléments <x>.

x[1]/y[1]

Premier <y> à l'intérieur du premier <x>.

Les exemples ci-dessus sont de simples références à des collections XPath qui utilisent des valeurs par défaut implicites, telles que l'axe child::. Pour cet axe, la collection de nœuds enfants est indexée dans l'ordre normal du document.

Pour les autres axes, tels que ancestor::, utilisez explicitement le nom de l'axe dans votre expression XPath. Pour cet axe, la collection d'ancêtres est indexée dans l'ordre inverse du document. Considérez l'exemple suivant du tableau ci-dessus :

x/y[1]

Cette expression est équivalente à l'expression suivante :

x/child::y[1]

Ces deux expressions signifient « pour chaque élément <x>, sélectionner le premier élément enfant appelé <y> ».

L'exemple suivant utilise la même syntaxe.

x/ancestor::y[1]

Cet exemple signifie « pour chaque élément <x>, sélectionner le premier élément ancêtre (dans l'ordre inverse du document) appelé <y> ». La syntaxe est la même, mais l'ordre est inversé.

La fonction last() retourne la valeur True pour le dernier élément d'une collection. Notez que last se rapporte au nœud parent.

ms256090.collapse_all(fr-fr,VS.120).gifExemples

Expression

Référence

book[last()]

Dernier élément <book>.

book/author[last()]

Dernier élément <author> à l'intérieur de chaque élément <book>.

(book/author)[last()]

Dernier élément <author> de tout l'ensemble d'éléments <author> à l'intérieur d'éléments <book>.

Des parenthèses peuvent permettre de regrouper des opérateurs de collection à des fins de clarté ou lorsque l'ordre normal de priorité ne convient pas pour exprimer une opération. Les opérateurs de regroupement peuvent être utilisés dans n'importe quelle expression de filtre (prédicat), telle que author[(degree or award)and publication]. Ils peuvent également être utilisés dans l'expression de pas de niveau supérieur, telle que (book|magazine) ou (author/degree | book/award). Ils ne peuvent pas être appliqués à des expressions de pas de niveau inférieur. Par exemple, author/(degree | award) n'est pas valide.

ms256090.collapse_all(fr-fr,VS.120).gifExemples

Expression

Référence

(book/author)

Tous les éléments <author> qui sont des éléments enfants de tout élément <book> du nœud de contexte actuel.

author[(degree or award) and publication]

Tous les éléments <author> qui contiennent au moins un élément <degree> ou <award> et au moins un élément <publication>.

Afficher: