XPathNodeIterator Classe

Definição

public ref class XPathNodeIterator abstract : ICloneable

public ref class XPathNodeIterator abstract : ICloneable, System::Collections::IEnumerable

public abstract class XPathNodeIterator : ICloneable

public abstract class XPathNodeIterator : ICloneable, System.Collections.IEnumerable

type XPathNodeIterator = class
    interface ICloneable

type XPathNodeIterator = class
    interface ICloneable
    interface IEnumerable

type XPathNodeIterator = class
    interface IEnumerable
    interface ICloneable

Public MustInherit Class XPathNodeIterator
Implements ICloneable

Public MustInherit Class XPathNodeIterator
Implements ICloneable, IEnumerable

Herança

Object

XPathNodeIterator

Implementações

ICloneable IEnumerable

Exemplos

O exemplo seguinte utiliza o Select método da XPathNavigator classe para selecionar um conjunto de nós usando a XPathNodeIterator classe.

XPathDocument document = new XPathDocument("books.xml");
XPathNavigator navigator = document.CreateNavigator();

XPathNodeIterator nodes = navigator.Select("/bookstore/book");
nodes.MoveNext();
XPathNavigator nodesNavigator = nodes.Current;

XPathNodeIterator nodesText = nodesNavigator.SelectDescendants(XPathNodeType.Text, false);

while (nodesText.MoveNext())
    Console.WriteLine(nodesText.Current.Value);

Dim document As XPathDocument = New XPathDocument("books.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

Dim nodes As XPathNodeIterator = navigator.Select("/bookstore/book")
nodes.MoveNext()
Dim nodesNavigator As XPathNavigator = nodes.Current

Dim nodesText As XPathNodeIterator = nodesNavigator.SelectDescendants(XPathNodeType.Text, False)

While nodesText.MoveNext()
    Console.WriteLine(nodesText.Current.Value)
End While

O exemplo usa o arquivo books.xml como entrada.

<?xml version="1.0" encoding="utf-8" ?>
<bookstore>
    <book genre="autobiography" publicationdate="1981-03-22" ISBN="1-861003-11-0">
        <title>The Autobiography of Benjamin Franklin</title>
        <author>
            <first-name>Benjamin</first-name>
            <last-name>Franklin</last-name>
        </author>
        <price>8.99</price>
    </book>
    <book genre="novel" publicationdate="1967-11-17" ISBN="0-201-63361-2">
        <title>The Confidence Man</title>
        <author>
            <first-name>Herman</first-name>
            <last-name>Melville</last-name>
        </author>
        <price>11.99</price>
    </book>
    <book genre="philosophy" publicationdate="1991-02-15" ISBN="1-861001-57-6">
        <title>The Gorgias</title>
        <author>
            <name>Plato</name>
        </author>
        <price>9.99</price>
    </book>
</bookstore>

Observações

Um objeto devolvido XPathNodeIterator pela XPathNavigator classe não está posicionado no primeiro nó de um conjunto selecionado de nós. Deve ser feita uma chamada ao MoveNext método da XPathNodeIterator classe para posicionar o XPathNodeIterator objeto no primeiro nó do conjunto selecionado de nós.

Ao usar o XPathNodeIterator, se editar o nó atual ou qualquer um dos seus antecessores, a sua posição atual perde-se. Se quiseres editar vários nós que selecionaste, cria um XPathNavigator array, copia todos os nós do XPathNodeIterator para o array, depois itera pelo array e modifica os nós.

Existem duas formas de iterar sobre uma XPathNavigator coleção usando a XPathNodeIterator classe.

Uma forma é usar o MoveNext método e depois chamar Current para obter a instância atual XPathNavigator , como no seguinte exemplo:

while (nodeIterator.MoveNext())
{
    XPathNavigator n = nodeIterator.Current;
    Console.WriteLine(n.LocalName);
}

While nodeIterator.MoveNext()
    Dim n As XPathNavigator = nodeIterator.Current
    Console.WriteLine(n.LocalName)
End While

Outra forma é usar um foreach loop para chamar o GetEnumerator método e usar a interface retornada IEnumerator para enumerar os nós, como no seguinte exemplo:

foreach (XPathNavigator n in nodeIterator)
    Console.WriteLine(n.LocalName);

For Each n As XPathNavigator In nodeIterator
    Console.WriteLine(nav.LocalName)
Next

Deves usar MoveNext e Current /ou usar GetEnumerator. Combinar estas duas abordagens pode causar resultados inesperados. Por exemplo, se o MoveNext método for chamado primeiro, e depois o GetEnumerator método for chamado no foreach ciclo, o foreach ciclo não começará a enumerar os resultados desde o início da coleção, mas sim pela posição após o Current método.

Notas para Implementadores

Quando herdas da XPathNodeIterator classe, deves sobrepor os seguintes membros:

• Clone()

• Current

• CurrentPosition

• MoveNext()