Condividi tramite


XPathNavigator.ComparePosition(XPathNavigator) Metodo

Definizione

Confronta la posizione dell'oggetto XPathNavigator corrente con quello dell'oggetto XPathNavigator specificato.

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

Parametri

nav
XPathNavigator

Oggetto XPathNavigator con cui eseguire il confronto.

Restituisce

XmlNodeOrder

Valore XmlNodeOrder che rappresenta la posizione comparata dei due oggetti XPathNavigator.

Commenti

Nella tabella seguente viene descritta l'enumerazione XmlNodeOrder .

XmlNodeOrder Descrizione
Before Il nodo corrente di si trova XPathNavigator prima del nodo corrente dell'oggetto fornito XPathNavigator.
After Il nodo corrente di questo XPathNavigator oggetto è dopo il nodo corrente dell'oggetto fornito XPathNavigator.
Same I due XPathNavigator oggetti sono posizionati sullo stesso nodo.
Unknown Le posizioni dei nodi non possono essere determinate l'una rispetto all'altra nell'ordine del documento o null vengono specificate come XPathNavigator parametro . Questo problema può verificarsi se i due nodi risiedono in strutture ad albero diverse.

Il ComparePosition comportamento del metodo dipende dall'oggetto XPathNodeType XPathNavigator su cui è attualmente posizionato. Quando si confrontano nodi nel documento XML, si applicano le regole seguenti:

  • Element nodi: questi nodi vengono restituiti nell'ordine dei documenti dal documento di origine.

  • Namespace nodi: questi nodi possono essere restituiti in ordine di documento e sono sempre prima dei Attribute nodi dell'elemento padre.

  • Attribute nodi: questi nodi possono essere restituiti nell'ordine dei documenti. Vengono sempre dopo i Namespace nodi e prima di tutti i nodi figlio del nodo padre.

Nota

Per altre informazioni sul modello di dati XPath e sui dettagli su ognuno dei tipi di nodo, vedere la sezione 5 della raccomandazione W3C XML Path Language (XPath).

Questo metodo non ha alcun effetto sullo stato dell'oggetto XPathNavigator.

Nota

Usare il IsSamePosition metodo anziché il ComparePosition metodo quando possibile.

Si applica a

Vedi anche