XPathNavigator.Name Eigenschaft

Definition

Namespace:

System.Xml.XPath

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Quelle:

XPathNavigator.cs

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der qualifizierte Name des aktuellen Knotens angezeigt.

public:
 abstract property System::String ^ Name { System::String ^ get(); };

public abstract string Name { get; }

member this.Name : string

Public MustOverride ReadOnly Property Name As String

Eigenschaftswert

String

A String that contains the qualified Name of the current node, or Empty if the current node does not have a name (for example, text or comment nodes).

Beispiele

Das folgende Beispiel durchläuft rekursiv die Knotenstruktur und zeigt Informationen zu Element und Text Knoten an.

static void XPathNavigatorMethods_MoveToNext()
{

    XPathDocument document = new XPathDocument("books.xml");
    XPathNavigator navigator = document.CreateNavigator();
    XPathNodeIterator nodeset = navigator.Select("descendant::book[author/last-name='Melville']");

    while (nodeset.MoveNext())
    {
        // Clone iterator here when working with it.
        RecursiveWalk(nodeset.Current.Clone());
    }
}

public static void RecursiveWalk(XPathNavigator navigator)
{
    switch (navigator.NodeType)
    {
        case XPathNodeType.Element:
            if (string.IsNullOrEmpty(navigator.Prefix))
                Console.WriteLine("<{0}>", navigator.LocalName);
            else
                Console.Write("<{0}:{1}>", navigator.Prefix, navigator.LocalName);
            Console.WriteLine("\t" + navigator.NamespaceURI);
            break;
        case XPathNodeType.Text:
            Console.WriteLine("\t" + navigator.Value);
            break;
    }

    if (navigator.MoveToFirstChild())
    {
        do
        {
            RecursiveWalk(navigator);
        } while (navigator.MoveToNext());

        navigator.MoveToParent();
        if (navigator.NodeType == XPathNodeType.Element)
            Console.WriteLine("</{0}>", navigator.Name);
    }
    else
    {
        if (navigator.NodeType == XPathNodeType.Element)
        {
            Console.WriteLine("</{0}>", navigator.Name);
        }
    }
}

Shared Sub XPathNavigatorMethods_MoveToNext()

    Dim document As XPathDocument = New XPathDocument("books.xml")
    Dim navigator As XPathNavigator = document.CreateNavigator()
    Dim nodeset As XPathNodeIterator = navigator.Select("descendant::book[author/last-name='Melville']")

    While nodeset.MoveNext()
        ' Clone iterator here when working with it.
        RecursiveWalk(nodeset.Current.Clone())
    End While

End Sub

Shared Sub RecursiveWalk(ByVal navigator As XPathNavigator)

    Select Case navigator.NodeType
        Case XPathNodeType.Element
            If navigator.Prefix = String.Empty Then
                Console.WriteLine("<{0}>", navigator.LocalName)
            Else
                Console.Write("<{0}:{1}>", navigator.Prefix, navigator.LocalName)
                Console.WriteLine(vbTab + navigator.NamespaceURI)
            End If
        Case XPathNodeType.Text
            Console.WriteLine(vbTab + navigator.Value)
    End Select

    If navigator.MoveToFirstChild() Then
        Do
            RecursiveWalk(navigator)
        Loop While (navigator.MoveToNext())

        navigator.MoveToParent()
        If (navigator.NodeType = XPathNodeType.Element) Then
            Console.WriteLine("</{0}>", navigator.Name)
        End If
    Else
        If navigator.NodeType = XPathNodeType.Element Then
            Console.WriteLine("</{0}>", navigator.Name)
        End If
    End If

End Sub

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

Die Name Zurückgegebene hängt vom aktuellen Knoten ab XPathNodeType . Der Name für das <bk:book> Element lautet bk:bookz. B. .

In der folgenden Tabelle wird der von der Name Eigenschaft zurückgegebene Wert basierend auf dem XPathNodeType aktuellen Knoten aufgelistet.

Xpathnodetype	Eigenschaftswert
Element	Der qualifizierte Name des Element. Im folgenden Beispiel <bk:book>lautet bk:bookder Name des Elementknotens .
Attribute	Der qualifizierte Name des Attribute. Im folgenden Beispiel <book bk:genre='novel'>lautet bk:genreder Name des Attribute Knotens .
Namespace	Das Dem Namespace-URI zugeordnete Präfix. In der folgenden Namespacedeklaration gibt xmlns:bk='urn:samples'die Name Eigenschaft zurück bk.
ProcessingInstruction	Das Ziel der ProcessingInstruction. Im folgenden Beispiel <?xml-stylesheet type='text/xsl' href= 'books.xsl'?>gibt die Name Eigenschaft zurück xml-stylesheet.
Alle anderen XPathNodeType Knoten	String.Empty.

Weitere Informationen

• LocalName
• Prefix