XPathNavigator.MoveToFirstAttribute-Methode

Artikel
08/20/2007

Verschiebt den XPathNavigator beim Überschreiben in einer abgeleiteten Klasse auf das erste Attribut des aktuellen Knotens.

Namespace: System.Xml.XPath
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public MustOverride Function MoveToFirstAttribute As Boolean
'Usage
Dim instance As XPathNavigator
Dim returnValue As Boolean

returnValue = instance.MoveToFirstAttribute

public abstract bool MoveToFirstAttribute ()

public:
virtual bool MoveToFirstAttribute () abstract

public abstract boolean MoveToFirstAttribute ()

public abstract function MoveToFirstAttribute () : boolean

Rückgabewert

Gibt true zurück, wenn der XPathNavigator auf das erste Attribut des aktuellen Knotens verschoben werden konnte, andernfalls false. Wenn false, bleibt die Position des XPathNavigator unverändert.

Hinweise

Wenn der XPathNavigator derzeit nicht auf einem Element positioniert ist, gibt diese Methode false zurück, und die Position des XPathNavigator bleibt unverändert.

Nach einem erfolgreichen Aufruf von MoveToFirstAttribute spiegeln die LocalName-Eigenschaft, die NamespaceURI-Eigenschaft und die Prefix-Eigenschaft die Werte des Attributs wider. Wenn sich der XPathNavigator auf einem Attribut befindet, sind die MoveToNext-Methode, die MoveToPrevious-Methode und die MoveToFirst-Methode nicht anwendbar. Diese Methoden geben immer false zurück und ändern die Position des XPathNavigator nicht. Um zum nächsten Attributknoten zu wechseln, können Sie stattdessen MoveToNextAttribute aufrufen.

Sobald der XPathNavigator auf einem Attribut positioniert ist, können Sie MoveToParent aufrufen, um zum Besitzerelement zu wechseln.

Beispiel

Im folgenden Beispiel werden die MoveToFirstAttribute-Methode und die MoveToNextAttribute-Methode verwendet, um alle Attribute für jedes Buch in der Datei books.xml anzuzeigen.

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

' Select all book nodes and display all attributes on each book.
Dim nodes As XPathNodeIterator = navigator.SelectDescendants("book", "", False)
While nodes.MoveNext()
    Dim navigator2 As XPathNavigator = nodes.Current.Clone()
    navigator2.MoveToFirstAttribute()
    Console.WriteLine("{0} = {1}", navigator2.Name, navigator2.Value)

    While navigator2.MoveToNextAttribute()
        Console.WriteLine("{0} = {1}", navigator2.Name, navigator2.Value)
    End While

    Console.WriteLine()
End While

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

// Select all book nodes and display all attributes on each book.
XPathNodeIterator nodes = navigator.SelectDescendants("book", "", false);
while (nodes.MoveNext())
{
    XPathNavigator navigator2 = nodes.Current.Clone();
    navigator2.MoveToFirstAttribute();
    Console.WriteLine("{0} = {1}", navigator2.Name, navigator2.Value);

    while (navigator2.MoveToNextAttribute())
    {
        Console.WriteLine("{0} = {1}", navigator2.Name, navigator2.Value);
    }
      
    Console.WriteLine();
}

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

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

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

XPathNavigator-Klasse
XPathNavigator-Member
System.Xml.XPath-Namespace
MoveToAttribute
MoveToNextAttribute
GetAttribute
HasAttributes

Freigeben über