XPathNodeIterator Klasse

Definition

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

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

public ref class XPathNodeIterator abstract : ICloneable

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

public abstract class XPathNodeIterator : System.Collections.IEnumerable

public abstract class XPathNodeIterator : ICloneable

type XPathNodeIterator = class
    interface IEnumerable
    interface ICloneable

type XPathNodeIterator = class
    interface IEnumerable

type XPathNodeIterator = class
    interface ICloneable

type XPathNodeIterator = class
    interface ICloneable
    interface IEnumerable

Public MustInherit Class XPathNodeIterator
Implements ICloneable, IEnumerable

Public MustInherit Class XPathNodeIterator
Implements IEnumerable

Public MustInherit Class XPathNodeIterator
Implements ICloneable

Vererbung

Object

XPathNodeIterator

Implementiert

IEnumerable ICloneable

Beispiele

Im folgenden Beispiel wird die Select Methode der XPathNavigator Klasse verwendet, um einen Knotensatz mithilfe der XPathNodeIterator Klasse auszuwählen.

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

Im Beispiel wird die books.xml Datei als Eingabe verwendet.

<?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>

Hinweise

Ein XPathNodeIterator von der XPathNavigator Klasse zurückgegebenes Objekt wird nicht auf dem ersten Knoten in einer ausgewählten Gruppe von Knoten positioniert. Ein Aufruf der MoveNext Methode der XPathNodeIterator Klasse muss erfolgen, um das XPathNodeIterator Objekt auf dem ersten Knoten in der ausgewählten Gruppe von Knoten zu positionieren.

Wenn Sie den XPathNodeIteratoraktuellen Knoten oder eines seiner Vorgänger bearbeiten, geht Ihre aktuelle Position verloren. Wenn Sie eine Anzahl von ausgewählten Knoten bearbeiten möchten, erstellen Sie ein XPathNavigator Array, kopieren Sie alle Knoten aus dem XPathNodeIterator Array in das Array, durchlaufen Sie das Array, und ändern Sie die Knoten.

Es gibt zwei Möglichkeiten zum Durchlaufen einer XPathNavigator Auflistung mithilfe der XPathNodeIterator Klasse.

Eine Möglichkeit besteht darin, die MoveNext Methode zu verwenden und dann aufzurufen Current , um die aktuelle XPathNavigator Instanz abzurufen, wie im folgenden Beispiel gezeigt:

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

Eine weitere Möglichkeit besteht darin, eine foreach Schleife zum Aufrufen der GetEnumerator Methode zu verwenden und die zurückgegebene IEnumerator Schnittstelle zum Aufzählen der Knoten zu verwenden, wie im folgenden Beispiel gezeigt:

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

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

Sie sollten entweder verwenden MoveNext und Current oder verwenden GetEnumerator. Die Kombination dieser beiden Ansätze kann zu unerwarteten Ergebnissen führen. Wenn die MoveNext Methode beispielsweise zuerst aufgerufen wird und die GetEnumerator Methode in der foreach Schleife aufgerufen wird, beginnt die foreach Schleife nicht mit dem Aufzählen der Ergebnisse vom Anfang der Auflistung, sondern von der Position nach der Current Methode.

Hinweise für Ausführende

Wenn Sie von der XPathNodeIterator Klasse erben, müssen Sie die folgenden Member überschreiben:

• Clone()

• Current

• CurrentPosition

• MoveNext()