Compartilhar via


XPathNavigator.ComparePosition(XPathNavigator) Método

Definição

Compara a posição do XPathNavigator atual 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 com o qual comparar.

Retornos

XmlNodeOrder

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

Comentários

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

Xmlnodeorder Descrição
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 entre si 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 XPathNodeType XPathNavigator 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.

Observação

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 nenhum efeito sobre o estado do XPathNavigator.

Observação

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

Aplica-se a

Confira também