XPathNavigator.ComparePosition(XPathNavigator) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
A XPathNavigator comparar.
Devoluções
Um valor que XmlNodeOrder representa a posição comparativa dos dois XPathNavigator objetos.
Observações
A tabela seguinte descreve a XmlNodeOrder enumeração.
| XmlNodeOrder | Descrição |
|---|---|
| Before | O nó atual deste XPathNavigator está antes do nó atual do fornecido XPathNavigator. |
| After | O nó atual deste XPathNavigator está após o nó atual do fornecido XPathNavigator. |
| Same | Os dois XPathNavigator objetos estão posicionados no mesmo nó. |
| Unknown | As posições dos nós não podem ser determinadas relativamente umas às outras na ordem do documento, nem null são especificadas como parâmetro XPathNavigator . Isto pode acontecer se os dois nós estiverem em árvores diferentes. |
O ComparePosition comportamento do método depende do XPathNodeTypeXPathNavigator que está atualmente posicionado. Ao comparar nós no documento XML, aplicam-se as seguintes regras:
Element nós: Estes nós são devolvidos por ordem de documento a partir do documento de origem.
Namespace nós: Estes nós podem ser devolvidos por ordem de documento e estão sempre antes dos Attribute nós do elemento pai.
Attribute nós: Estes nós podem ser devolvidos por ordem de documentos. Eles vêm sempre depois dos Namespace nós e antes de quaisquer nós filhos do nó pai.
Note
Para mais informações sobre o modelo de dados XPath e detalhes sobre cada um dos tipos de nós, consulte a secção 5 da recomendação da W3C XML Path Language (XPath ).
Este método não tem efeito no estado do XPathNavigator.
Note
Use o IsSamePosition método em vez do ComparePosition método sempre que possível.