XPathNodeIterator.Current プロパティ

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

XPathNodeIterator.Current プロパティ

派生クラスでオーバーライドされた場合、現在のコンテキスト ノードに配置されている、この XPathNodeIterator に対する XPathNavigator オブジェクトを返します。

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

Visual Basic (宣言)

Public MustOverride ReadOnly
 Property Current As XPathNavigator

Visual Basic (使用法)

Dim instance As XPathNodeIterator
Dim value As XPathNavigator

value = instance.Current

C#

public abstract XPathNavigator Current { get;
 }

C++

public:
virtual property XPathNavigator^ Current {
    XPathNavigator^ get () abstract;
}

J#

/** @property */
public abstract XPathNavigator get_Current ()

JScript

public abstract function get
 Current () : XPathNavigator

プロパティ値
ノード セットの選択元であるコンテキスト ノードに配置されている XPathNavigator オブジェクト。XPathNodeIterator を選択ノード セットの最初のノードに移動するには、MoveNext メソッドを呼び出す必要があります。

解説

返される XPathNavigator オブジェクトのプロパティを使用すると、現在のノードの情報を取得できます。ただし、返された XPathNavigator オブジェクトは変更しないでください。返された XPathNavigator オブジェクトは、選択したノード セットから移動できません。

変更を加える場合は、XPathNavigator クラスの Clone メソッドを使用して、XPathNavigator オブジェクトを複製してください。複製した XPathNavigator オブジェクトは、選択したノード セットから移動できます。この XPathNavigator オブジェクトの複製メソッドは、XPath クエリのパフォーマンスに影響を与える可能性があります。

SelectAncestors、SelectDescendants、および SelectChildren の各メソッドを実行した結果、ノードが 1 つも選択されていない状態になった場合、Current プロパティはコンテキスト ノードを指しているとは限りません。

ノードが選択されているかどうかをテストするには、Count プロパティを使用します。これを次の例に示します。

使用例

XPathNodeIterator オブジェクトの Current プロパティ、および XPathNavigator クラスの Clone メソッドを使用して、Herman Melville の著書のタイトルをすべて取得する例を次に示します。

Visual Basic

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

C#

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);
}

C++

XPathDocument^ document = gcnew XPathDocument("books.xml");
XPathNavigator^ navigator = document->CreateNavigator();
XPathExpression^ query = 
    navigator->Compile("/bookstore/book");
XPathNodeIterator^ nodes = navigator->Select(query);
XPathNavigator^ nodesNavigator = nodes->Current;
for each(XPathNavigator^ navigator in nodesNavigator->
    SelectDescendants(XPathNodeType::Text, false))
{
    Console::Write(navigator->Name);
    Console::WriteLine(navigator->Value);
}

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

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

プラットフォーム

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

参照

関連項目
XPathNodeIterator クラス
XPathNodeIterator メンバ
System.Xml.XPath 名前空間
MoveNext
Clone
SelectAncestors
SelectDescendants
SelectChildren
XPathNodeIterator.Count プロパティ