DataTable.Merge メソッド

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

DataTable.Merge メソッド (DataTable)

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

指定した DataTable を現在の DataTable とマージします。

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

Visual Basic (宣言)

Public Sub Merge ( _
    table As DataTable _
)

Visual Basic (使用法)

Dim instance As DataTable
Dim table As DataTable

instance.Merge(table)

C#

public void Merge (
    DataTable table
)

C++

public:
void Merge (
    DataTable^ table
)

J#

public void Merge (
    DataTable table
)

JScript

public function Merge (
    table : DataTable
)

パラメータ

table

現在の DataTable とマージする DataTable。

解説

Merge メソッドを使用して、スキーマがほとんど同様の 2 つの DataTable オブジェクトをマージします。マージは、通常、データ ソースから既存の DataTable に直前の変更を組み込むために、クライアント アプリケーションで使用されます。これにより、クライアント アプリケーションが更新された DataTable と、データ ソースからの最新データを入手できます。

マージ操作では、元のテーブルおよびマージするテーブルだけが考慮されます。子テーブルは影響を受けることも追加されることもありません。テーブルに、リレーションシップの一部として定義された 1 つ以上の子テーブルが存在する場合、各子テーブルを個別にマージする必要があります。

通常、Merge メソッドは、変更の検証、エラーの調整、変更されたデータ ソースの更新、および最後に既存の DataTable の更新に関係する一連のプロシージャの終わりに呼び出されます。

マージを実行する場合、既定では、マージ操作中はマージ前に既存のデータに加えられた変更が保持されます。この動作を変更するには、このメソッドの他の 2 つのオーバーロードのどちらかを呼び出し、preserveChanges パラメータを false に指定します。

クライアント アプリケーションには通常、変更されたデータを収集し、中間層コンポーネントに戻す前に検証するためにクリックできる単一のボタンがあります。このシナリオでは、初めに GetChanges メソッドを呼び出します。このメソッドは、検証とマージのために最適化された 2 番目の DataTable を返します。2 番目の DataTable オブジェクトには、変更された DataRow オブジェクトだけが含まれ、元の DataTable のサブセットになります。このサブセットは一般的に小さいため、中間層コンポーネントに効率よく渡されます。次に、中間層コンポーネントは、ストアド プロシージャを通じて変更のある元のデータ ソースを更新します。次に、中間層は (元のクエリを再び実行することによって) 元のデータとデータ ソースからの最新のデータを含む新しい DataTable を返信するか、データ ソースから変更の加えられたサブセットを返信できます。たとえば、データ ソースが自動的に一意の主キー値を作成する場合、その値はクライアント アプリケーションに反映できます。どちらの場合にも、返された DataTable は、Merge メソッドで、クライアント アプリケーションの元の DataTable にマージできます。

新しいソース DataTable をターゲットにマージする場合、DataRowState 値が Unchanged、Modified、または Deleted であるすべてのソース行が、同じ主キー値を持つターゲット行と照合されます。DataRowState 値が Added のソース行は、新しいソース行と同じ主キー値を持つ新しいターゲット行と照合されます。

使用例

次に示すコンソール アプリケーションの例では、単純な DataTable を作成して、このテーブルにデータを追加します。次にテーブルのコピーを作成し、そのコピーに行を追加します。最後に Merge メソッドを呼び出し、最初のテーブルのデータと 2 番目のテーブルのデータをマージします。

Visual Basic

Private Sub DemonstrateMergeTable()
  Dim table1 As New DataTable("Items")

  ' Add columns
  Dim column1 As New DataColumn("id",
 GetType(System.Int32))
  Dim column2 As New DataColumn("item",
 GetType(System.Int32))
  table1.Columns.Add(column1)
  table1.Columns.Add(column2)

  ' Set the primary key column.
  table1.PrimaryKey = New DataColumn() {column1}

  ' Add RowChanged event handler for the table.
  AddHandler table1.RowChanged, AddressOf Row_Changed

  ' Add some rows.
  Dim row As DataRow
  For i As Integer = 0 To
 3
    row = table1.NewRow()
    row("id") = i
    row("item") = i
    table1.Rows.Add(row)
  Next i

  ' Accept changes.
  table1.AcceptChanges()
  PrintValues(table1, "Original values")

  ' Create a second DataTable identical to the first.
  Dim table2 As DataTable = table1.Clone()

  ' Add three rows. Note that the id column can't be the 
  ' same as existing rows in the original table.
  row = table2.NewRow()
  row("id") = 14
  row("item") = 774
  table2.Rows.Add(row)

  row = table2.NewRow()
  row("id") = 12
  row("item") = 555
  table2.Rows.Add(row)

  row = table2.NewRow()
  row("id") = 13
  row("item") = 665
  table2.Rows.Add(row)

  ' Merge table2 into the table1.
  Console.WriteLine("Merging")
  table1.Merge(table2)
  PrintValues(table1, "Merged With table1")

End Sub

Private Sub Row_Changed(ByVal
 sender As Object, _
  ByVal e As DataRowChangeEventArgs)
  Console.WriteLine("Row changed {0}{1}{2}", _
    e.Action, ControlChars.Tab, e.Row.ItemArray(0))
End Sub

Private Sub PrintValues(ByVal
 table As DataTable, _
  ByVal label As String)
  ' Display the values in the supplied DataTable:
  Console.WriteLine(label)
  For Each row As DataRow
 In table.Rows
    For Each col As DataColumn
 In table.Columns
      Console.Write(ControlChars.Tab + " " + row(col).ToString())
    Next col
    Console.WriteLine()
  Next row
End Sub

C#

private static void DemonstrateMergeTable()
{
    DataTable table1 = new DataTable("Items");

    // Add columns
    DataColumn column1 = new DataColumn("id", typeof(System.Int32));
    DataColumn column2 = new DataColumn("item", typeof(System.Int32));
    table1.Columns.Add(column1);
    table1.Columns.Add(column2);

    // Set the primary key column.
    table1.PrimaryKey = new DataColumn[] { column1 };

    // Add RowChanged event handler for the table.
    table1.RowChanged += 
        new System.Data.DataRowChangeEventHandler(Row_Changed);

    // Add some rows.
    DataRow row;
    for (int i = 0; i <= 3; i++)
    {
        row = table1.NewRow();
        row["id"] = i;
        row["item"] = i;
        table1.Rows.Add(row);
    }

    // Accept changes.
    table1.AcceptChanges();
    PrintValues(table1, "Original values");

    // Create a second DataTable identical to the first.
    DataTable table2 = table1.Clone();

    // Add three rows. Note that the id column can't be the 
    // same as existing rows in the original table.
    row = table2.NewRow();
    row["id"] = 14;
    row["item"] = 774;
    table2.Rows.Add(row);

    row = table2.NewRow();
    row["id"] = 12;
    row["item"] = 555;
    table2.Rows.Add(row);

    row = table2.NewRow();
    row["id"] = 13;
    row["item"] = 665;
    table2.Rows.Add(row);

    // Merge table2 into the table1.
    Console.WriteLine("Merging");
    table1.Merge(table2);
    PrintValues(table1, "Merged With table1");

}

private static void Row_Changed(object
 sender, 
    DataRowChangeEventArgs e)
{
    Console.WriteLine("Row changed {0}\t{1}", 
        e.Action, e.Row.ItemArray[0]);
}

private static void PrintValues(DataTable
 table, string label)
{
    // Display the values in the supplied DataTable:
    Console.WriteLine(label);
    foreach (DataRow row in table.Rows)
    {
        foreach (DataColumn col in table.Columns)
        {
            Console.Write("\t " + row[col].ToString());
        }
        Console.WriteLine();
    }
}

プラットフォーム

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
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
DataTable クラス
DataTable メンバ
System.Data 名前空間
その他の技術情報
DataTable の作成と使用
DataTable の作成と使用

DataTable.Merge メソッド

指定した DataTable を現在の DataTable とマージします。
オーバーロードの一覧

名前	説明
DataTable.Merge (DataTable)	指定した DataTable を現在の DataTable とマージします。 .NET Compact Framework によってサポートされています。
DataTable.Merge (DataTable, Boolean)	指定した DataTable を現在の DataTable とマージし、現在の DataTable の変更を保持するかどうかを指定します。 .NET Compact Framework によってサポートされています。
DataTable.Merge (DataTable, Boolean, MissingSchemaAction)	指定した DataTable を現在の DataTable とマージして、現在の DataTable の変更を保持するかどうかを指定し、さらに欠けているスキーマの処理方法を指定します。 .NET Compact Framework によってサポートされています。

参照

関連項目

DataTable クラス
DataTable メンバ
System.Data 名前空間

その他の技術情報

DataTable の作成と使用
DataTable の作成と使用

DataTable の作成と使用