XmlNode.CloneNode メソッド

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

C#

public abstract XmlNode CloneNode (
    bool deep
)

C++

public:
virtual XmlNode^ CloneNode (
    bool deep
) abstract

J#

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

C#

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 );
}

J#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

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