XPathNavigator.ComparePosition(XPathNavigator) Metoda

Definicja

Porównuje położenie bieżącego XPathNavigator z pozycją określonego 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

Parametry

nav
XPathNavigator

Element XPathNavigator do porównania.

Zwraca

XmlNodeOrder

Wartość XmlNodeOrder reprezentująca pozycję porównawczą dwóch XPathNavigator obiektów.

Uwagi

W poniższej XmlNodeOrder tabeli opisano wyliczenie.

XmlNodeOrder Opis
Before Bieżący węzeł tego XPathNavigator węzła znajduje się przed bieżącym węzłem dostarczonego XPathNavigatorelementu .
After Bieżący węzeł tego XPathNavigator elementu znajduje się po bieżącym węźle dostarczonego XPathNavigatorelementu .
Same Dwa XPathNavigator obiekty są umieszczone w tym samym węźle.
Unknown Nie można określić pozycji węzła względem siebie w kolejności dokumentu lub null jest określony jako XPathNavigator parametr. Taka sytuacja może wystąpić, jeśli dwa węzły znajdują się w różnych drzewach.

Zachowanie ComparePosition metody jest zależne od XPathNodeType elementu XPathNavigator , na który jest obecnie umieszczony. Podczas porównywania węzłów w dokumencie XML obowiązują następujące reguły:

  • Element węzły: te węzły są zwracane w kolejności dokumentu źródłowego.

  • Namespace węzły: te węzły mogą być zwracane w kolejności dokumentu i są zawsze przed Attribute węzłami elementu nadrzędnego.

  • Attribute węzły: te węzły mogą być zwracane w kolejności dokumentu. Zawsze są one wykonywane po Namespace węzłach i przed wszystkimi węzłami podrzędnym węzła nadrzędnego.

Uwaga

Aby uzyskać więcej informacji na temat modelu danych XPath i szczegółów dotyczących każdego z typów węzłów, zobacz sekcję 5 zalecenia W3C XML Path Language (XPath).

Ta metoda nie ma wpływu na stan .XPathNavigator

Uwaga

IsSamePosition Użyj metody, a nie ComparePosition metody, jeśli jest to możliwe.

Dotyczy

Zobacz też