XPathNavigator.SetValue メソッド

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

XPathNavigator.SetValue メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

現在のノードの値を設定します。

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

Visual Basic (宣言)

Public Overridable Sub SetValue
 ( _
    value As String _
)

Visual Basic (使用法)

Dim instance As XPathNavigator
Dim value As String

instance.SetValue(value)

C#

public virtual void SetValue (
    string value
)

C++

public:
virtual void SetValue (
    String^ value
)

J#

public void SetValue (
    String value
)

JScript

public function SetValue (
    value : String
)

パラメータ

value

ノードの新しい値。

例外

例外の種類	条件
ArgumentNullException	値パラメータが null 参照 (Visual Basic では Nothing) です。
InvalidOperationException	XPathNavigator がルート ノードまたは名前空間ノードに配置されているか、指定された値が無効です。
NotSupportedException	XPathNavigator は編集をサポートしていません。

解説

• XPathNavigator が複雑な内容 (子要素) を持つ要素ノードに配置されている場合、SetValue メソッドを呼び出すと、新しい文字列値が格納されたテキスト ノードで子要素が置き換えられます。

• SetValue メソッドは、ルート ノードおよび名前空間ノードを更新できません。

使用例

XPath 式の名前空間プレフィックスを解決する XmlNamespaceManager オブジェクトを使用して contosoBooks.xml ファイル内のすべての price 要素を更新するために、SetValue メソッドを使用する例を次に示します。

Visual Basic

Dim document As XmlDocument = New
 XmlDocument()
document.Load("contosoBooks.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

Dim manager As XmlNamespaceManager = New
 XmlNamespaceManager(navigator.NameTable)
manager.AddNamespace("bk", "http://www.contoso.com/books")

For Each nav As XPathNavigator
 In navigator.Select("//bk:price",
 manager)
    If nav.Value = "11.99" Then
        nav.SetValue("12.99")
    End If
Next

Console.WriteLine(navigator.OuterXml)

C#

XmlDocument document = new XmlDocument();
document.Load("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();

XmlNamespaceManager manager = new XmlNamespaceManager(navigator.NameTable);
manager.AddNamespace("bk", "http://www.contoso.com/books");

foreach (XPathNavigator nav in navigator.Select("//bk:price",
 manager))
{
    if(nav.Value == "11.99")
    {
        nav.SetValue("12.99");
    }
}

Console.WriteLine(navigator.OuterXml);

この例では、入力として、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

参照

関連項目
XPathNavigator クラス
XPathNavigator メンバ
System.Xml.XPath 名前空間