XPathNavigator.ComparePosition(XPathNavigator) Metodo

Definizione

Confronta la posizione dell'oggetto corrente XPathNavigator con la posizione 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 da confrontare.

Valori restituiti

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

Commenti

Nella tabella seguente viene descritta l'enumerazione XmlNodeOrder .

XmlNodeOrder Description
Before Il nodo corrente di questo XPathNavigator oggetto è prima del nodo corrente dell'oggetto XPathNavigatorfornito.
After Il nodo corrente di questo XPathNavigator oggetto è dopo il nodo corrente dell'oggetto XPathNavigatorfornito.
Same I due XPathNavigator oggetti sono posizionati nello stesso nodo.
Unknown Le posizioni dei nodi non possono essere determinate l'una rispetto all'altra nell'ordine del documento oppure null vengono specificate come XPathNavigator parametro. Questo problema può verificarsi se i due nodi si trovano in alberi diversi.

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

  • Element nodi: questi nodi vengono restituiti in ordine di documento 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.

Note

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.

Note

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

Si applica a

Vedi anche