XmlDataDocument.CloneNode メソッド

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

XmlDataDocument.CloneNode メソッド

現在のノードの複製を作成します。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

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

returnValue = instance.CloneNode(deep)

C#

public override XmlNode CloneNode (
    bool deep
)

C++

public:
virtual XmlNode^ CloneNode (
    bool deep
) override

J#

public XmlNode CloneNode (
    boolean deep
)

JScript

public override function CloneNode (
    deep : boolean
) : XmlNode

パラメータ

deep

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

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

解説

XmlDataDocument のクローンを作成すると、DataSet スキーマのクローンも作成されます。

deep を false に設定した場合は、クローンとして作成された DataSet にはデータがない、つまり行がありません。

deep を true に設定した場合は、クローンとして作成された DataSet はスキーマを使用して設定され、データが読み込まれます。

このメソッドが異なるノード型でどのように動作するかを説明した表を確認するには、XmlNode クラスの CloneNode のトピックを参照してください。

使用例

DataSet を XmlDataDocument に読み込み、XmlDataDocument の簡易クローンを作成する例を次に示します。

この例では、SQL Server 2000 Northwind データベースを使用しています。

Visual Basic

Imports System
Imports System.Xml
Imports System.Data
Imports System.Data.SqlClient
 
 
public class Sample
 
  public shared sub Main()
   
    Dim dsNorthwind as DataSet = new
 DataSet()
 
    'Create the connection string.
    Dim sConnect as String
           
    sConnect="Data Source=localhost;Integrated Security=SSPI;Initial
 Catalog=Northwind"     
          
    'Create a connection object to connect to the northwind db.
    Dim nwconnect as SqlConnection
    nwconnect = new SqlConnection(sConnect)
 
    'Create a command string to select all the customers in the WA region.
    Dim sCommand as String
 = "Select * from Customers where Region='WA'"
 
    'Create an Adapter to load the DataSet.
    Dim myDataAdapter as SqlDataAdapter
    myDataAdapter = new SqlDataAdapter(sCommand, nwconnect)
 
    'Fill the DataSet with the selected records.
    myDataAdapter.Fill(dsNorthwind, "Customers")
 
    'Load the document with the DataSet.
    Dim doc as XmlDataDocument = new
 XmlDataDocument(dsNorthwind)  
 
    'Create a shallow clone of the XmlDataDocument. Note that although
    'none of the child nodes were copied over, the cloned node does
    'have the schema information.
    Dim clone as XmlDataDocument
    clone = CType (doc.CloneNode(false), XmlDataDocument) 
    Console.WriteLine("Child count: {0}", clone.ChildNodes.Count)
    Console.WriteLine(clone.DataSet.GetXmlSchema())
 
  end sub
end class

C#

using System;
using System.Data;
using System.Xml;
using System.Data.SqlClient;

public class Sample
{
  public static void Main()
  {
     DataSet dsNorthwind = new DataSet();

     //Create the connection string.           
     String sConnect;
     sConnect="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind";
     
         
     //Create a connection object to connect to the northwind db.
     SqlConnection nwconnect = new SqlConnection(sConnect);

     //Create a command string to select all the customers in the WA
 region.
     String sCommand = "Select * from Customers where Region='WA'";

     //Create an adapter to load the DataSet.
     SqlDataAdapter myDataAdapter = new SqlDataAdapter(sCommand,
 nwconnect);

     //Fill the DataSet with the selected records.
     myDataAdapter.Fill(dsNorthwind,"Customers");

     //Load the document with the DataSet.
     XmlDataDocument doc = new XmlDataDocument(dsNorthwind); 
  

     //Create a shallow clone of the XmlDataDocument. Note that although
     //none of the child nodes were copied over, the cloned node does
     //have the schema information.
     XmlDataDocument clone = (XmlDataDocument) doc.CloneNode(false);
     Console.WriteLine("Child count: {0}", clone.ChildNodes.Count);
     Console.WriteLine(clone.DataSet.GetXmlSchema());   
  }
}

C++

#using <System.Xml.dll>
#using <System.Transactions.dll>
#using <System.EnterpriseServices.dll>
#using <System.dll>
#using <System.Data.dll>

using namespace System;
using namespace System::Data;
using namespace System::Xml;
using namespace System::Data::SqlClient;
int main()
{
   DataSet^ dsNorthwind = gcnew DataSet;
   
   //Create the connection string.           
   String^ sConnect;
   sConnect = "Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind";
   
   //Create a connection object to connect to the northwind db.
   SqlConnection^ nwconnect = gcnew SqlConnection( sConnect );
   
   //Create a command string to select all the customers in the WA region.
   String^ sCommand = "Select * from Customers where Region='WA'";
   
   //Create an adapter to load the DataSet.
   SqlDataAdapter^ myDataAdapter = gcnew SqlDataAdapter( sCommand,nwconnect );
   
   //Fill the DataSet with the selected records.
   myDataAdapter->Fill( dsNorthwind, "Customers" );
   
   //Load the document with the DataSet.
   XmlDataDocument^ doc = gcnew XmlDataDocument( dsNorthwind );
   
   //Create a shallow clone of the XmlDataDocument. Note that although
   //none of the child nodes were copied over, the cloned node does
   //have the schema information.
   XmlDataDocument^ clone = dynamic_cast<XmlDataDocument^>(doc->CloneNode(
 false ));
   Console::WriteLine( "Child count: {0}", clone->ChildNodes->Count
 );
   Console::WriteLine( clone->DataSet->GetXmlSchema() );
}

J#

import System.*;
import System.Data.*;
import System.Xml.*;
import System.Data.SqlClient.*;

public class Sample
{
    public static void main(String[]
 args)
    {
        DataSet dsNorthwind = new DataSet();

        //Create the connection string.           
        String sConnect;
        sConnect = "Data Source=localhost;Integrated Security=SSPI;"
            + "Initial Catalog=Northwind";

        //Create a connection object to connect to the northwind db.
        SqlConnection nwConnect = new SqlConnection(sConnect);

        //Create a command string to select all the customers in the WA
 region.
        String sCommand = "Select * from Customers where Region='WA'";

        //Create an adapter to load the DataSet.
        SqlDataAdapter myDataAdapter = new SqlDataAdapter(sCommand,
 nwConnect);

        //Fill the DataSet with the selected records.
        myDataAdapter.Fill(dsNorthwind, "Customers");

        //Load the document with the DataSet.
        XmlDataDocument doc = new XmlDataDocument(dsNorthwind);

        //Create a shallow clone of the XmlDataDocument. Note that although
        //none of the child nodes were copied over, the cloned node
 does
        //have the schema information.
        XmlDataDocument clone = (XmlDataDocument)doc.CloneNode(false);
        Console.WriteLine("Child count: {0}", 
            System.Convert.ToString(clone.get_ChildNodes().get_Count()));
        Console.WriteLine(clone.get_DataSet().GetXmlSchema());
    } //main
} //Sample

プラットフォーム

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、1.1、1.0

参照

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