XPathNavigator.ComparePosition(XPathNavigator) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.XmlNodeOrderPublic Overridable Function ComparePosition (nav As XPathNavigator) As XmlNodeOrderParâmetros
- nav
- XPathNavigator
O XPathNavigator com o qual comparar.
Retornos
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.