XPathNavigator.ComparePosition(XPathNavigator) Método

Definição

Namespace:
System.Xml.XPath
Assemblies:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.XPath.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs

Compara a posição da corrente XPathNavigator com a posição do XPathNavigator especificado.

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

Parâmetros

nav
XPathNavigator

O XPathNavigator para comparar.

Retornos

XmlNodeOrder

Um XmlNodeOrder valor que representa a posição comparativa dos dois XPathNavigator objetos.

Comentários

A tabela a seguir descreve a XmlNodeOrder enumeração.

Xmlnodeorder Description
Before O nó atual disso XPathNavigator é antes do nó atual do fornecido XPathNavigator.
After O nó atual disso XPathNavigator é após o nó atual do fornecido XPathNavigator.
Same Os dois XPathNavigator objetos são posicionados no mesmo nó.
Unknown As posições do nó não podem ser determinadas em relação umas às outras na ordem do documento ou null são especificadas como o XPathNavigator parâmetro. Isso poderá ocorrer se os dois nós residirem em árvores diferentes.

O ComparePosition comportamento do método depende do XPathNodeTypeXPathNavigator posicionamento no momento. Ao comparar nós no documento XML, as seguintes regras se aplicam:

  • Element nós: esses nós são retornados na ordem do documento do documento de origem.

  • Namespace nós: esses nós podem ser retornados na ordem do documento e estão sempre antes dos Attribute nós do elemento pai.

  • Attribute nós: esses nós podem ser retornados na ordem do documento. Eles sempre vêm atrás dos Namespace nós e antes de qualquer nó filho do nó pai.

Note

Para obter mais informações sobre o modelo de dados XPath e detalhes sobre cada um dos tipos de nó, consulte a seção 5 da recomendação XPath (Linguagem de Caminho XML) W3C.

Esse método não tem efeito sobre o estado do XPathNavigator.

Note

Use o IsSamePosition método em vez do ComparePosition método quando possível.

Aplica-se a

Confira também