XPathNavigator.ComparePosition(XPathNavigator) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
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.