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

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

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

XmlNode.CloneNode メソッド

派生クラスでオーバーライドされた場合は、ノードの複製を作成します。

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

Visual Basic (宣言)

Public MustOverride Function
 CloneNode ( _
    deep As Boolean _
) As XmlNode

Visual Basic (使用法)

Dim instance As XmlNode
Dim deep As Boolean
Dim returnValue As XmlNode

returnValue = instance.CloneNode(deep)

public abstract XmlNode CloneNode (
    bool deep
)

C++

public:
virtual XmlNode^ CloneNode (
    bool deep
) abstract

public abstract XmlNode CloneNode (
    boolean deep
)

JScript

public abstract function CloneNode (
    deep : boolean
) : XmlNode

パラメータ

deep: 指定したノードの下にあるサブツリーのクローンを順次作成していく場合は true。指定したノードだけのクローンを作成する場合は false。

戻り値
クローンとして作成されたノード。

例外

例外の種類	条件
InvalidOperationException	クローンを作成できないノード型でこのメソッドを呼び出しています。

解説

このメソッドは、ノードのコピーコンストラクタとして機能します。複製されたノードには親がありません。ParentNode は null 参照 (Visual Basic では Nothing) を返します。

各 XmlNodeType の固有の動作を次の表に示します。

XmlNodeType	CloneNode(true)	CloneNode(false)
属性	子ノードを含めて、属性ノードのクローンを作成します。	子ノードを含めて、属性ノードのクローンを作成します。
CData	データの内容を含めて、CData ノードのクローンを作成します。	データの内容を含めて、CData ノードのクローンを作成します。
Comment	テキストの内容を含めて、コメントノードのクローンを作成します。	テキストの内容を含めて、コメントノードのクローンを作成します。
Document	子ノードを含めて、ドキュメントノードのクローンを作成します。	ドキュメントノードのクローンを作成します。
DocumentFragment	子ノードを含めて、ドキュメントフラグメントノードのクローンを作成します。	ドキュメントフラグメントノードのクローンを作成します。
DocumentType	ドキュメント型ノードのクローンを作成します。	ドキュメント型ノードのクローンを作成します。
Element	要素ノード、その属性、および子ノードのクローンを作成します。	既定の属性を含めて、要素ノードとその属性のクローンを作成します。
Entity	エンティティノードのクローンは作成できません。	エンティティノードのクローンは作成できません。
EntityReference	エンティティ参照ノードのクローンを作成します。置換テキストは含まれません。	エンティティ参照ノードのクローンを作成します。置換テキストは含まれません。
Notation	表記ノードのクローンは作成できません。	表記ノードのクローンは作成できません。
ProcessingInstruction	対象およびデータを含めて、処理命令ノードのクローンを作成します。	対象およびデータを含めて、処理命令ノードのクローンを作成します。
SignificantWhitespace	データ値を含めて、有意な空白ノードのクローンを作成します。	データ値を含めて、有意な空白ノードのクローンを作成します。
Text	データ値を含めて、テキストノードのクローンを作成します。	データ値を含めて、テキストノードのクローンを作成します。
Whitespace	データ値を含めて、空白ノードのクローンを作成します。	データ値を含めて、空白ノードのクローンを作成します。
XmlDeclaration	データ値を含めて、XmlDeclaration ノードのクローンを作成します。	データ値を含めて、XmlDeclaration ノードのクローンを作成します。
その他のすべてのノード型。	これらのノード型はクローンを作成できません。	これらのノード型はクローンを作成できません。

使用例

詳細クローンと簡易クローンの違いの例を次に示します。

Visual Basic

Option Explicit
Option Strict

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        
        Dim doc As New XmlDocument()
        doc.LoadXml("<book ISBN='1-861001-57-5'>" &
 _
                    "<title>Pride And Prejudice</title>"
 & _
                    "<price>19.95</price>"
 & _
                    "</book>")
        
        Dim root As XmlNode = doc.FirstChild
        
        'Create a deep clone.  The cloned node 
        'includes the child nodes.
        Dim deep As XmlNode = root.CloneNode(True)
        Console.WriteLine(deep.OuterXml)
        
        'Create a shallow clone.  The cloned node does not 
        'include the child nodes, but does include its attribute.
        Dim shallow As XmlNode = root.CloneNode(False)
        Console.WriteLine(shallow.OuterXml)
    End Sub 'Main
End Class 'Sample

using System;
using System.IO;
using System.Xml;

public class Sample {

  public static void Main()
 {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "<price>19.95</price>" +
                "</book>");

    XmlNode root = doc.FirstChild;

    //Create a deep clone.  The cloned node 
    //includes the child nodes.
    XmlNode deep = root.CloneNode(true);
    Console.WriteLine(deep.OuterXml);

    //Create a shallow clone.  The cloned node does not 
    //include the child nodes, but does include its attribute.
    XmlNode shallow = root.CloneNode(false);
    Console.WriteLine(shallow.OuterXml);
  }
}

C++

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<book ISBN='1-861001-57-5'>"
   "<title>Pride And Prejudice</title>"
   "<price>19.95</price>"
   "</book>" );
   XmlNode^ root = doc->FirstChild;
   
   //Create a deep clone.  The cloned node 
   //includes the child nodes.
   XmlNode^ deep = root->CloneNode( true );
   Console::WriteLine( deep->OuterXml );
   
   //Create a shallow clone.  The cloned node does not 
   //include the child nodes, but does include its attribute.
   XmlNode^ shallow = root->CloneNode( false );
   Console::WriteLine( shallow->OuterXml );
}

import System.*;
import System.IO.*;
import System.Xml.*;

public class Sample
{
    public static void main(String[]
 args)
    {
        XmlDocument doc = new XmlDocument();
        doc.LoadXml("<book ISBN='1-861001-57-5'>"
            + "<title>Pride And Prejudice</title>"
            + "<price>19.95</price>"
            + "</book>");

        XmlNode root = doc.get_FirstChild();

        //Create a deep clone.  The cloned node 
        //includes the child nodes.
        XmlNode deep = root.CloneNode(true);
        Console.WriteLine(deep.get_OuterXml());

        //Create a shallow clone.  The cloned node does not 
        //include the child nodes, but does include its attribute.
        XmlNode shallow = root.CloneNode(false);
        Console.WriteLine(shallow.get_OuterXml());
    } //main
} //Sample