Esplorazione del set di nodi con XPathNavigator

Dopo aver selezionato un gruppo di nodi, è possibile spostarsi in maniera casuale all'interno di questo. È importante sottolineare che dopo aver selezionato i nodi con Select, è necessario richiamare MoveNext per posizionare lo strumento di selezione sul primo nodo che corrisponde ai criteri di selezione. Molti dei metodi Move descritti in questa sezione consentono di spostarsi tra tutti i nodi tranne quelli di attributo e dello spazio dei nomi. Per un esempio di come esplorare i nodi di attributo e dello spazio dei nomi con XPathNavigator, vedere Esplorazione degli attributi e degli spazi dei nomi con XPathNavigator.

Nella tabella che segue vengono illustrati i metodi di esplorazione disponibili e viene data una descrizione di come si spostano.

Metodo Descrizione
MoveTo Sposta uno strumento di selezione alla posizione corrente nella quale si trova un altro strumento di selezione dato. Restituisce un valore Boolean che indica la riuscita dello spostamento.
MoveToNext Sposta XPathNavigator sul pari livello successivo del nodo corrente.
MoveToPrevious Sposta XPathNavigator sul pari livello precedente del nodo corrente.
MoveToFirst Sposta XPathNavigator sul primo pari livello del nodo corrente.
MoveToFirstChild Sposta XPathNavigator sul primo figlio del nodo corrente. Questo metodo è valido solo sul nodo di primo livello e sui tipi di nodi che hanno altri nodi figlio. I nodi di attributo e dello spazio dei nomi non vengono interpretati come nodi figlio dei nodi di elementi.
MoveToParent Sposta XPathNavigator sul padre del nodo corrente. Il primo livello non ha padre. Tutti gli altri tipi di nodo si spostano sull'elemento padre o di primo livello.
MoveToRoot Sposta XPathNavigator al nodo di primo livello che possiede questo nodo.
MoveToId Sposta XPathNavigator sul nodo avente un attributo di tipo ID, il cui valore corrisponde alla stringa data

Lo spostamento dei metodo all'interno di un documento viene eseguito dall'alto verso il basso. I metodi MoveTo e MoveToId non funzionano su un XmlDataDocument.

Vedere anche

XPathNavigator in .NET Framework | Tipi di nodo riconosciuti con le query XPath | Esplorazione degli attributi e degli spazi dei nomi con XPathNavigator | Compilazione, selezione, valutazione e corrispondenze con XPath e XPathExpressions