XPathNavigator.ComparePosition-Methode

Artikel
08/20/2007

Vergleicht die Position des aktuellen XPathNavigator mit der Position des angegebenen XPathNavigator.

Namespace: System.Xml.XPath
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public Overridable Function ComparePosition ( _
    nav As XPathNavigator _
) As XmlNodeOrder
'Usage
Dim instance As XPathNavigator
Dim nav As XPathNavigator
Dim returnValue As XmlNodeOrder

returnValue = instance.ComparePosition(nav)

public virtual XmlNodeOrder ComparePosition (
    XPathNavigator nav
)

public:
virtual XmlNodeOrder ComparePosition (
    XPathNavigator^ nav
)

public XmlNodeOrder ComparePosition (
    XPathNavigator nav
)

public function ComparePosition (
    nav : XPathNavigator
) : XmlNodeOrder

Parameter

nav
Der zu vergleichende XPathNavigator.

Rückgabewert

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 liegt vor dem aktuellen Knoten des angegebenen XPathNavigator.
After	Der aktuelle Knoten dieses XPathNavigator liegt nach dem aktuellen Knoten des angegebenen XPathNavigator.
Same	Die beiden XPathNavigator-Objekte sind auf demselben Knoten positioniert.
Unknown	Die Knotenpositionen können nicht relativ zueinander in der Dokumentreihenfolge bestimmt werden, oder als XPathNavigator-Parameter wurde NULL (Nothing in Visual Basic) angegeben. Dieser Fall kann auftreten, wenn sich die beiden Knoten in unterschiedlichen Strukturen befinden.

Das Verhalten der ComparePosition-Methode ist abhängig vom XPathNodeType, auf dem sich der XPathNavigator gerade befindet. Beim Vergleichen von Knoten im XML-Dokument gelten die folgenden Regeln:

Element-Knoten: Diese Knoten werden in Dokumentreihenfolge des Quelldokuments zurückgegeben.
Namespace-Knoten: Diese Knoten können in Dokumentreihenfolge zurückgegeben werden und stehen immer vor den Attribute-Knoten des übergeordneten Elements.
Attribute-Knoten: Diese Knoten können in Dokumentreihenfolge zurückgegeben werden. Sie stehen immer hinter den Namespace-Knoten und vor beliebigen untergeordneten Knoten des übergeordneten Knotens.

Hinweis

Weitere Informationen über das XPath-Datenmodell und Details zu jedem der Knotentypen finden Sie unter Abschnitt 5 der W3C-Empfehlung zur XML Path Language (XPath) unter http://www.w3.org/TR/xpath#data-model (nur auf Englisch verfügbar).

Diese Methode hat keine Auswirkungen auf den Zustand von XPathNavigator.

Hinweis

Verwenden Sie möglichst anstelle der ComparePosition-Methode die IsSamePosition-Methode.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

XPathNavigator-Klasse
XPathNavigator-Member
System.Xml.XPath-Namespace
IsSamePosition

Freigeben über