XPathNodeIterator.Current Eigenschaft

public:
 abstract property System::Xml::XPath::XPathNavigator ^ Current { System::Xml::XPath::XPathNavigator ^ get(); };

public abstract System.Xml.XPath.XPathNavigator? Current { get; }

public abstract System.Xml.XPath.XPathNavigator Current { get; }

member this.Current : System.Xml.XPath.XPathNavigator

Public MustOverride ReadOnly Property Current As XPathNavigator

Eigenschaftswert

Ein XPathNavigator Objekt, das auf dem Kontextknoten positioniert ist, von dem der Knotensatz ausgewählt wurde. Die MoveNext() Methode muss aufgerufen werden, um den XPathNodeIterator ersten Knoten im ausgewählten Satz zu verschieben.

Beispiele

Im folgenden Beispiel werden alle Buchtitel, die von Herman Melville erstellt wurden, mithilfe der Current Eigenschaft des XPathNodeIterator Objekts und der Clone Methode der XPathNavigator Klasse abruft.

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

// Select all books authored by Melville.
XPathNodeIterator nodes = navigator.Select("descendant::book[author/last-name='Melville']");

while (nodes.MoveNext())
{
    // Clone the navigator returned by the Current property.
    // Use the cloned navigator to get the title element.
    XPathNavigator clone = nodes.Current.Clone();
    clone.MoveToFirstChild();
    Console.WriteLine("Book title: {0}", clone.Value);
}

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

' Select all books authored by Melville.
Dim nodes As XPathNodeIterator = navigator.Select("descendant::book[author/last-name='Melville']")

While nodes.MoveNext()
    ' Clone the navigator returned by the Current property. 
    ' Use the cloned navigator to get the title element.
    Dim clone As XPathNavigator = nodes.Current.Clone()
    clone.MoveToFirstChild()
    Console.WriteLine("Book title: {0}", clone.Value)
End While

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

<?xml version="1.0" encoding="utf-8" ?>
<bookstore xmlns="http://www.contoso.com/books">
    <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

Sie können die Eigenschaften des zurückgegebenen XPathNavigator Objekts verwenden, um Informationen zum aktuellen Knoten abzurufen. Das zurückgegebene XPathNavigator Objekt sollte jedoch nicht geändert werden. Das zurückgegebene XPathNavigator Objekt kann nicht vom ausgewählten Knotensatz entfernt werden.

Alternativ können Sie das XPathNavigator Objekt mithilfe der Clone Methode der XPathNavigator Klasse klonen. Das geklonte XPathNavigator Objekt kann dann vom ausgewählten Knotensatz weg verschoben werden. Diese Methode zum Klonen des XPathNavigator Objekts kann sich auf die Leistung der XPath-Abfrage auswirken.

Wenn die SelectAncestors, SelectDescendantsund SelectChildren Methoden dazu führen, dass keine Knoten ausgewählt werden, zeigt die Current Eigenschaft möglicherweise nicht auf den Kontextknoten.

Um zu testen, ob Knoten ausgewählt wurden, verwenden Sie die Count Eigenschaft wie im folgenden Beispiel gezeigt.

Weitere Informationen

• MoveNext()
• Clone()
• SelectAncestors
• SelectDescendants
• SelectChildren
• Count