XPathNavigator.ComparePosition(XPathNavigator) Méthode

Définition

Compare la position du XPathNavigator en cours avec la position du 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 avec lequel effectuer la comparaison.

Retours

XmlNodeOrder

Une valeur de XmlNodeOrder représentant la position comparative des deux objets XPathNavigator.

Remarques

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

XmlNodeOrder Description
Before Le nœud actuel de celui-ci XPathNavigator est avant le nœud actuel de l’élément fourni XPathNavigator.
After Le nœud actuel de celui-ci XPathNavigator est après le nœud actuel du fichier 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 à l’autre dans l’ordre de document ou null sont spécifiées en tant que 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 XPathNavigator XPathNodeType 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 de document à 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.

Notes

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 XPathNavigatordu .

Notes

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

S’applique à

Voir aussi