XPathNavigator.ComparePosition(XPathNavigator) Méthode

Définition

Compare la position du courant XPathNavigator à la position de l’élément XPathNavigator spécifié.

public:
 virtual System::Xml::XmlNodeOrder ComparePosition(System::Xml::XPath::XPathNavigator ^ nav);
public virtual System.Xml.XmlNodeOrder ComparePosition(System.Xml.XPath.XPathNavigator? nav);
public virtual System.Xml.XmlNodeOrder ComparePosition(System.Xml.XPath.XPathNavigator nav);
abstract member ComparePosition : System.Xml.XPath.XPathNavigator -> System.Xml.XmlNodeOrder
override this.ComparePosition : System.Xml.XPath.XPathNavigator -> System.Xml.XmlNodeOrder
Public Overridable Function ComparePosition (nav As XPathNavigator) As XmlNodeOrder

Paramètres

nav
XPathNavigator

À XPathNavigator comparer.

Retours

Valeur XmlNodeOrder représentant la position comparative des deux XPathNavigator objets.

Remarques

Le tableau suivant décrit l’énumération XmlNodeOrder .

XmlNodeOrder Description
Before Le nœud actuel de ce XPathNavigator nœud est avant le nœud actuel du nœud fourni XPathNavigator.
After Le nœud actuel de celui-ci XPathNavigator se trouve après le nœud actuel du nœud fourni XPathNavigator.
Same Les deux XPathNavigator objets sont positionnés sur le même nœud.
Unknown Les positions de nœud ne peuvent pas être déterminées par rapport entre elles dans l’ordre du document ou null sont spécifiées comme XPathNavigator paramètre. Cela peut se produire si les deux nœuds résident dans des arborescences différentes.

Le ComparePosition comportement de la méthode dépend de l’élément XPathNodeTypeXPathNavigator actuellement positionné. Lorsque vous comparez des nœuds dans le document XML, les règles suivantes s’appliquent :

  • Element nœuds : ces nœuds sont retournés dans l’ordre des documents à partir du document source.

  • Namespace nœuds : ces nœuds peuvent être retournés dans l’ordre des documents et sont toujours avant les Attribute nœuds de l’élément parent.

  • Attribute nœuds : ces nœuds peuvent être retournés dans l’ordre des documents. Ils viennent toujours après les Namespace nœuds et avant tous les nœuds enfants du nœud parent.

Note

Pour plus d’informations sur le modèle de données XPath et les détails sur chacun des types de nœuds, consultez la section 5 de la recommandation XPath (W3C XML Path Language).

Cette méthode n’a aucun effet sur l’état du XPathNavigator.

Note

Utilisez la IsSamePosition méthode plutôt que la ComparePosition méthode si possible.

S’applique à

Voir aussi