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

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

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

XPathNavigator.InsertElementAfter メソッド

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

指定された値と共に指定した名前空間プレフィックス、ローカル名、および名前空間 URI を使用して、現在のノードの後に新しい兄弟要素を作成します。

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

Visual Basic (宣言)

Public Overridable Sub InsertElementAfter
 ( _
    prefix As String, _
    localName As String, _
    namespaceURI As String, _
    value As String _
)

Visual Basic (使用法)

Dim instance As XPathNavigator
Dim prefix As String
Dim localName As String
Dim namespaceURI As String
Dim value As String

instance.InsertElementAfter(prefix, localName, namespaceURI, value)

public virtual void InsertElementAfter (
    string prefix,
    string localName,
    string namespaceURI,
    string value
)

C++

public:
virtual void InsertElementAfter (
    String^ prefix, 
    String^ localName, 
    String^ namespaceURI, 
    String^ value
)

public void InsertElementAfter (
    String prefix, 
    String localName, 
    String namespaceURI, 
    String value
)

JScript

public function InsertElementAfter (
    prefix : String, 
    localName : String, 
    namespaceURI : String, 
    value : String
)

パラメータ

prefix: 新しい子要素の名前空間プレフィックス (存在する場合)。

localName: 新しい子要素のローカル名 (存在する場合)。

namespaceURI: 新しい子要素の名前空間 URI (存在する場合)。Empty と null 参照 (Visual Basic では Nothing) は等価です。

value: 新しい子要素の値。Empty または null 参照 (Visual Basic では Nothing) を渡すと、空の要素が作成されます。

例外

例外の種類	条件
InvalidOperationException	XPathNavigator の該当位置では、新しい兄弟ノードを現在のノードの後に挿入することはできません。
NotSupportedException	XPathNavigator は編集をサポートしていません。

解説

名前空間プレフィックス値と URI 値は、LookupPrefix メソッドまたは LookupNamespace メソッドを使用して取得できます。たとえば、構文 navigator.InsertElementAfter(navigator.Prefix, "pages", LookupNamespaceURI(navigator.Prefix), String.Empty) でスコープ内の名前空間 xmlns:bk="http://www.contoso.com/books" を使用して兄弟要素を挿入すると、新しい <bk:pages/> 兄弟要素が作成されます。

InsertElementAfter メソッドを使用するときに考慮する必要がある重要な注意事項を次に示します。

指定された名前空間プレフィックスが null 参照 (Visual Basic では Nothing) または String.Empty の場合、新しい要素の名前空間 URI 用のプレフィックスは、現在の名前空間のスコープ内から取得されます。指定した名前空間 URI に割り当てられた名前空間プレフィックスが現在のスコープにない場合、名前空間プレフィックスが自動的に生成されます。
InsertElementAfter メソッドは、XPathNavigator が要素、テキスト、処理命令、またはコメントノードに配置されている場合にのみ有効です。
InsertElementAfter メソッドは、XPathNavigator の位置に影響を与えません。

使用例

contosoBooks.xml ファイル内にある最初の book 要素の price 子要素の後に、新しい pages 要素を挿入する例を次に示します。

Visual Basic

Dim document As XmlDocument = New
 XmlDocument()
document.Load("contosoBooks.xml")
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")

navigator.InsertElementAfter(navigator.Prefix, "pages",
 navigator.LookupNamespace(navigator.Prefix), "100")

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

XmlDocument document = new XmlDocument();
document.Load("contosoBooks.xml");
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");

navigator.InsertElementAfter(navigator.Prefix, "pages", navigator.LookupNamespace(navigator.Prefix),
 "100");

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>