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, представляющее сравнительное положение двух объектов 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 метод.