XPathNavigator.DeleteSelf メソッド

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

XPathNavigator.DeleteSelf メソッド

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

現在のノードとその子ノードを削除します。

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

Visual Basic (宣言)

Public Overridable Sub DeleteSelf

Visual Basic (使用法)

Dim instance As XPathNavigator

instance.DeleteSelf

C#

public virtual void DeleteSelf ()

C++

public:
virtual void DeleteSelf ()

J#

public void DeleteSelf ()

JScript

public function DeleteSelf ()

例外

例外の種類	条件
InvalidOperationException	XPathNavigator が、ルート ノードまたは名前空間ノードに配置されています。
NotSupportedException	XPathNavigator は編集をサポートしていません。

解説

• 削除に成功した場合、XPathNavigator は削除されたノードの親ノードに配置されます。

• 削除したノードが単純型要素の内容を持つテキスト ノードの場合、その要素の型情報が失われます。これは、この要素に配置すると、XmlType、ValueType、および TypedValue の各プロパティが、それぞれ null 参照 (Visual Basic では Nothing)、String、および Empty の値を持つことを意味します。

• 削除されたノードでも、削除を実行するまでそれに配置されていた XPathNavigator オブジェクトにアクセスできます。ただし、削除したサブツリーからの移動を実行するメソッドは失敗します。たとえば、削除した最上位ノードに XPathNavigator が配置されていると、MoveToParent メソッドおよび MoveToPrevious メソッドは常に失敗します。これは、削除したノードが XML ドキュメントに接続されなくなるためです。同様に、削除した最下位ノードに XPathNavigator が配置されていると、MoveToNext メソッドは常に失敗します。

使用例

DeleteSelf メソッドを使用して、contosoBooks.xml ファイルにある最初の book 要素の price 要素を削除する例を次に示します。price 要素を削除した後の XPathNavigator オブジェクトの位置は、親の book 要素になります。

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.DeleteSelf()

Console.WriteLine("Position after delete: {0}", navigator.Name)
Console.WriteLine(navigator.OuterXml)

C#

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

Console.WriteLine("Position after delete: {0}", navigator.Name);
Console.WriteLine(navigator.OuterXml);

C++

XPathDocument^ document = gcnew XPathDocument("books.xml");
XPathNavigator^ navigator = document->CreateNavigator();
XPathNavigator^ node = 
    navigator->SelectSingleNode("//title");
Console::WriteLine(node->InnerXml);

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