XPathNavigator.ComparePosition(XPathNavigator) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Compara la posición del XPathNavigator actual con la del 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
El XPathNavigator con el que se va a comparar.
Devoluciones
Valor de XmlNodeOrder que representa la posición comparativa de los dos objetos XPathNavigator.
Comentarios
En la tabla siguiente se describe la XmlNodeOrder enumeración .
| XmlNodeOrder | Descripción |
|---|---|
| Before | El nodo actual de esto XPathNavigator es antes del nodo actual del proporcionado XPathNavigator. |
| After | El nodo actual de esto XPathNavigator es después del nodo actual del proporcionado XPathNavigator. |
| Same | Los dos XPathNavigator objetos se colocan en el mismo nodo. |
| Unknown | Las posiciones del nodo no se pueden determinar entre sí en el orden del documento o null se especifican como el XPathNavigator parámetro . Esto puede producirse si los dos nodos residen en diferentes árboles. |
El ComparePosition comportamiento del método depende de en el XPathNodeType XPathNavigator que está colocado actualmente. Al comparar nodos en el documento XML, se aplican las reglas siguientes:
Element nodos: estos nodos se devuelven en orden de documento desde el documento de origen.
Namespace nodos: estos nodos se pueden devolver en orden de documento y siempre están antes de los Attribute nodos del elemento primario.
Attribute nodos: estos nodos se pueden devolver en orden de documento. Siempre vienen después de los Namespace nodos y antes de los nodos secundarios del nodo primario.
Nota
Para obtener más información sobre el modelo de datos XPath y detalles sobre cada uno de los tipos de nodo, vea la sección 5 de la recomendación lenguaje de ruta de acceso XML (XPath) de W3C.
Este método no tiene ningún efecto en el estado de XPathNavigator.
Nota
Use el IsSamePosition método en lugar del ComparePosition método cuando sea posible.