XPathNavigator.ComparePosition(XPathNavigator) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Vergleicht die Position des aktuellen XPathNavigator mit der Position des angegebenen XPathNavigator.
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
Parameter
- nav
- XPathNavigator
XPathNavigator für den Vergleich.
Gibt zurück
Ein XmlNodeOrder-Wert, der die relative Position der beiden XPathNavigator-Objekte zueinander darstellt.
Hinweise
In der folgenden Tabelle wird die XmlNodeOrder Enumeration beschrieben.
XmlNodeOrder | BESCHREIBUNG |
---|---|
Before | Der aktuelle Knoten dieses XPathNavigator Knotens befindet sich vor dem aktuellen Knoten des angegebenen XPathNavigator. |
After | Der aktuelle Knoten ders XPathNavigator liegt nach dem aktuellen Knoten des angegebenen XPathNavigator. |
Same | Die beiden XPathNavigator Objekte werden auf demselben Knoten positioniert. |
Unknown | Die Knotenpositionen können nicht relativ zueinander in der Dokumentreihenfolge bestimmt werden oder null als XPathNavigator Parameter angegeben werden. Dieser Fall kann auftreten, wenn sich die beiden Knoten in unterschiedlichen Strukturen befinden. |
Das Verhalten der ComparePosition Methode hängt von der XPathNodeType XPathNavigator aktuell positionierten Position ab. Beim Vergleichen von Knoten im XML-Dokument gelten die folgenden Regeln:
Element knoten: Diese Knoten werden in der Dokumentreihenfolge aus dem Quelldokument zurückgegeben.
Namespace Knoten: Diese Knoten können in der Dokumentreihenfolge zurückgegeben werden und sind immer vor den Attribute Knoten des übergeordneten Elements.
Attribute Knoten: Diese Knoten können in der Dokumentreihenfolge zurückgegeben werden. Sie kommen immer nach den Namespace Knoten und vor allen untergeordneten Knoten des übergeordneten Knotens.
Hinweis
Weitere Informationen zum XPath-Datenmodell und details zu den einzelnen Knotentypen finden Sie unter Abschnitt 5 der Empfehlung zur W3C-XML-Pfadsprache (XPath).
Diese Methode hat keine Auswirkung auf den Zustand des XPathNavigator.
Hinweis
Verwenden Sie die Methode anstelle der IsSamePosition ComparePosition Methode, wenn möglich.