XPathNavigator.SetTypedValue メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

XPathNavigator.SetTypedValue メソッド

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

現在のノードの型指定された値を設定します。

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

Visual Basic (宣言)

Public Overridable Sub SetTypedValue
 ( _
    typedValue As Object _
)

Visual Basic (使用法)

Dim instance As XPathNavigator
Dim typedValue As Object

instance.SetTypedValue(typedValue)

public virtual void SetTypedValue (
    Object typedValue
)

C++

public:
virtual void SetTypedValue (
    Object^ typedValue
)

public void SetTypedValue (
    Object typedValue
)

JScript

public function SetTypedValue (
    typedValue : Object
)

パラメータ

typedValue: ノードの型指定された新しい値。

例外

例外の種類	条件
ArgumentException	XPathNavigator は、指定されたオブジェクトの型をサポートしていません。
ArgumentNullException	指定された値を null 参照 (Visual Basic では Nothing) にすることはできません。
InvalidOperationException	XPathNavigator が、要素ノードと属性ノードのいずれにも配置されていません。
NotSupportedException	XPathNavigator は編集をサポートしていません。

解説

スキーマ検証の XmlReader オブジェクトを実行した結果として XmlDocument オブジェクトが作成されている場合、SetTypedValue メソッドに指定された値が、XML ドキュメント用の XML スキーマ定義言語 (XSD スキーマで検証されます。指定された値が XML ドキュメントのスキーマに従っていない場合、XmlSchemaException がスローされます。

SetTypedValue メソッドは、XPathNavigator が要素ノードまたは属性ノードに配置されている場合にのみ有効です。

使用例

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

Visual Basic

Dim settings As XmlReaderSettings = New
 XmlReaderSettings()
settings.Schemas.Add("http://www.contoso.com/books",
 "contosoBooks.xsd")
settings.ValidationType = ValidationType.Schema

Dim reader As XmlReader = XmlReader.Create("contosoBooks.xml",
 settings)
Dim document As XmlDocument = New
 XmlDocument()
document.Load(reader)

Dim navigator As XPathNavigator = document.CreateNavigator()

navigator.MoveToChild("bookstore", "http://www.contoso.com/books")
navigator.MoveToChild("book", "http://www.contoso.com/books")
navigator.MoveToChild("price", "http://www.contoso.com/books")

Dim price As Decimal = 19.99
navigator.SetTypedValue(price)

navigator.MoveToParent()
Console.WriteLine(navigator.OuterXml)

XmlReaderSettings settings = new XmlReaderSettings();
settings.Schemas.Add("http://www.contoso.com/books", "contosoBooks.xsd");
settings.ValidationType = ValidationType.Schema;

XmlReader reader = XmlReader.Create("contosoBooks.xml", settings);
XmlDocument document = new XmlDocument();
document.Load(reader);

XPathNavigator navigator = document.CreateNavigator();

navigator.MoveToChild("bookstore", "http://www.contoso.com/books");
navigator.MoveToChild("book", "http://www.contoso.com/books");
navigator.MoveToChild("price", "http://www.contoso.com/books");

Decimal price = 19.99M;
navigator.SetTypedValue(price);

navigator.MoveToParent();
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>