XPathNavigator.ComparePosition(XPathNavigator) Метод

Определение

Сравнивает положение текущего XPathNavigator с положением заданного 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

Параметры

nav
XPathNavigator

Итератор XPathNavigator, с которым выполняется сравнение.

Возвращаемое значение

XmlNodeOrder

Значение XmlNodeOrder, представляющее сравнительное положение двух объектов XPathNavigator.

Комментарии

В следующей таблице описано перечисление XmlNodeOrder .

XmlNodeOrder Описание
Before Текущий узел этого XPathNavigator узла находится перед текущим узлом предоставленного XPathNavigator.
After Текущий узел этого XPathNavigator узла находится после текущего узла предоставленного XPathNavigator.
Same Два XPathNavigator объекта расположены на одном узле.
Unknown Позиции узлов не могут быть определены относительно друг друга в порядке документа или null указаны в качестве XPathNavigator параметра. Это может произойти, если два узла находятся в различных деревьях.

Поведение ComparePosition метода зависит от текущего XPathNodeType XPathNavigator расположения. При сравнении узлов в XML-документе применяются следующие правила:

  • Element узлы: эти узлы возвращаются в порядке документа из исходного документа.

  • Namespace узлы: эти узлы могут быть возвращены в порядке документа и всегда находятся перед Attribute узлами родительского элемента.

  • Attribute узлы: эти узлы могут быть возвращены в порядке документа. Они всегда приходят после Namespace узлов и перед любыми дочерними узлами родительского узла.

Примечание

Дополнительные сведения о модели данных XPath и сведения о каждом из типов узлов см. в разделе 5 рекомендации по языку XML-пути W3C (XPath).

Этот метод не влияет на состояние .XPathNavigator

Примечание

IsSamePosition По возможности используйте метод, а не ComparePosition метод.

Применяется к

См. также раздел