XPathNavigator.Name プロパティ

.NET Framework クラス ライブラリ リファレンス

XPathNavigator.Name プロパティ

派生クラスでオーバーライドされると、現在のノードの限定名を取得します。

名前空間: System.Xml.XPath
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public MustOverride ReadOnly
 Property Name As String

Visual Basic (使用法)

Dim instance As XPathNavigator
Dim value As String

value = instance.Name

C#

public abstract string Name { get;
 }

C++

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

J#

/** @property */
public abstract String get_Name ()

JScript

public abstract function get
 Name () : String

プロパティ値
現在のノードの修飾 Name が格納された String。現在のノードが名前を持たない場合 (たとえばテキスト ノードまたはコメント ノード) は String.Empty。

解説

返される Name は、現在のノードの XPathNodeType によって異なります。たとえば、<bk:book> 要素の名前は bk:book です。

現在のノードの XPathNodeType に応じて、Name プロパティによって返される値の表を次に示します。

XPathNodeType	プロパティ値
Element	Element の修飾名。たとえば次の例、<bk:book> では、要素ノードの名前は bk:book です。
Attribute	Attribute の修飾名。たとえば次の例、<book bk:genre='novel'> では、Attribute ノードの名前は bk:genre です。
Namespace	名前空間 URI に関連付けられたプリフィックス。次の名前空間宣言、xmlns:bk='urn:samples' では、Name プロパティは bk を返します。
ProcessingInstruction	ProcessingInstruction の対象。次の例、<?xml-stylesheet type='text/xsl' href= 'books.xsl'?> では、Name プロパティは xml-stylesheet を返します。
その他すべての XPathNodeType ノード	String.Empty.

使用例

ノード ツリーを再帰的に反復処理し、Element ノードおよび Text ノードについての情報を表示する例を次に示します。

Visual Basic

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

C#

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 (navigator.Prefix == String.Empty)
                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);
       }
    }
}

この例では、入力として、books.xml というファイルを使用しています。

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

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
XPathNavigator クラス
XPathNavigator メンバ
System.Xml.XPath 名前空間
XPathNavigator.LocalName プロパティ
Prefix