DataSet.Merge メソッド (DataTable)

[アーティクル]
03/28/2008

指定した DataTable およびそのスキーマを現在の DataSet にマージします。

Overloads Public Sub Merge( _
   ByVal table As DataTable _)
[C#]
public void Merge(DataTabletable);
[C++]
public: void Merge(DataTable* table);
[JScript]
public function Merge(
   table : DataTable);

パラメータ

table
マージするデータとスキーマが格納されている DataTable 。

例外

例外の種類	条件
ArgumentNullException	dataSet が null 参照 (Visual Basic では Nothing) です。

解説

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

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

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

Merge メソッドが呼び出されたときは、スキーマが変更されている可能性があるため、2 つの DataSet オブジェクトのスキーマが比較されます。たとえば、B to B シナリオでは、自動処理によって新しい列が XML スキーマに追加されていることがあります。ソース DataSet がターゲットに不足しているスキーマ要素 (追加された DataColumn オブジェクト) を格納している場合、そのスキーマ要素は引数 missingSchemaAction を MissingSchemaAction.Add に設定して、ターゲットに追加できます。この場合、マージされた DataSet は、追加されたスキーマとデータを格納します。

スキーマのマージ後に、データをマージします。

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

マージ中に、制約は無効になります。マージの終了時に制約を有効にできない場合は、 ConstraintException が生成され、制約は無効になりますが、マージされたデータは保持されます。この場合、 EnforceConstraints プロパティは false に設定され、無効なすべての行はエラー時にマークされます。エラーは、 EnforceConstraints プロパティを true にリセットする前に解決する必要があります。

使用例

[Visual Basic, C#, C++] 1 つのテーブル、2 列、および 10 行で単純な DataSet を作成する例を次に示します。最初の DataTable と同じテーブルをもう 1 つ作成します。2 つ目のテーブルに 2 行追加し、このテーブルを DataSet にマージします。

 
Private Sub DemonstrateMergeTable()
    ' Create a DataSet with one table, two columns, and ten rows.
    Dim ds As New DataSet("myDataSet")
    Dim t As New DataTable("Items")

    ' Add tables to the DataSet
    ds.Tables.Add(t)

    ' Add columns
    Dim c1 As New DataColumn("id", Type.GetType("System.Int32"), "")
    Dim c2 As New DataColumn("Item", Type.GetType("System.Int32"), "")
    t.Columns.Add(c1)
    t.Columns.Add(c2)

    ' DataColumn array to set primary key.
    Dim keyCol(1) As DataColumn

    ' Set primary key column.
    keyCol(0) = c1
    t.PrimaryKey = keyCol

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

    ' Add ten rows.
    Dim i As Integer
    Dim r As DataRow

    For i = 0 To 9
        r = t.NewRow()
        r("id") = i
        r("Item") = i
        t.Rows.Add(r)
    Next i

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

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

    ' Add three rows. Note that the id column can't be the 
    ' same as existing rows in the DataSet table.
    Dim newRow As DataRow
    newRow = t2.NewRow()
    newRow("id") = 14
    newRow("Item") = 774
    t2.Rows.Add(newRow)

    newRow = t2.NewRow()
    newRow("id") = 12
    newRow("Item") = 555
    t2.Rows.Add(newRow)

    newRow = t2.NewRow()
    newRow("id") = 13
    newRow("Item") = 665
    t2.Rows.Add(newRow)

    ' Merge the table into the DataSet.
    Console.WriteLine("Merging")
    ds.Merge(t2)
    PrintValues(ds, "Merged With Table")
End Sub 'DemonstrateMergeTable
    
Private Sub Row_Changed(sender As Object, e As DataRowChangeEventArgs)
    Console.WriteLine("Row Changed " + e.Action.ToString() _
       + ControlChars.Tab + e.Row.ItemArray(0).ToString())
End Sub 'Row_Changed

Private Sub PrintValues(ds As DataSet, label As String)
    Console.WriteLine(ControlChars.Cr + label)
    Dim t As DataTable
    Dim r As DataRow
    Dim c As DataColumn
    For Each t In  ds.Tables
        Console.WriteLine("TableName: " + t.TableName) 
        For Each r In  t.Rows             
            For Each c In  t.Columns
                Console.Write(ControlChars.Tab + " " + r(c).ToString())
            Next c
            Console.WriteLine()
        Next r
    Next t
End Sub

[C#] 
private void DemonstrateMergeTable(){
   // Create a DataSet with one table, two columns, and ten rows.
   DataSet ds = new DataSet("myDataSet");
   DataTable t = new DataTable("Items");

   // Add table to the DataSet
   ds.Tables.Add(t);

   // Add columns
   DataColumn c1 = new DataColumn("id", Type.GetType("System.Int32"),"");
   DataColumn c2 = new DataColumn("Item", Type.GetType("System.Int32"),"");
   t.Columns.Add(c1);
   t.Columns.Add(c2);

   // DataColumn array to set primary key.
   DataColumn[] keyCol= new DataColumn[1];

   // Set primary key column.
   keyCol[0]= c1;
   t.PrimaryKey=keyCol;

   // Add a RowChanged event handler for the table.
   t.RowChanged += new DataRowChangeEventHandler(Row_Changed);

   // Add ten rows.
   for(int i = 0; i <10;i++){
      DataRow r=t.NewRow();
      r["id"] = i;
      r["Item"]= i;
      t.Rows.Add(r);
   }
   // Accept changes.
   ds.AcceptChanges();

   PrintValues(ds, "Original values");

   // Create a second DataTable identical to the first.
   DataTable t2 = t.Clone();

   // Add three rows. Note that the id column can't be the
   // same as existing rows in the DataSet table.
   DataRow newRow;
   newRow = t2.NewRow();
   newRow["id"] = 14;
   newRow["item"] = 774;

   //Note the alternative method for adding rows.
   t2.Rows.Add(new Object[] { 12, 555 });
   t2.Rows.Add(new Object[] { 13, 665 });

   // Merge the table into the DataSet
   Console.WriteLine("Merging");
   ds.Merge(t2);
   PrintValues(ds, "Merged With table.");

}

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

private void PrintValues(DataSet ds, string label){
   Console.WriteLine("\n" + label);
   foreach(DataTable t in ds.Tables){
      Console.WriteLine("TableName: " + t.TableName);
      foreach(DataRow r in t.Rows){
         foreach(DataColumn c in t.Columns){
            Console.Write("\t " + r[c] );
         }
         Console.WriteLine();
      }
   }
}

[C++] 
private:
 void DemonstrateMergeTable(){
    // Create a DataSet with one table, two columns, and ten rows.
    DataSet* ds = new DataSet(S"myDataSet");
    DataTable* t = new DataTable(S"Items");

    // Add table to the DataSet
    ds->Tables->Add(t);

    // Add columns
    DataColumn* c1 = new DataColumn(S"id", Type::GetType(S"System.Int32"),S"");
    DataColumn* c2 = new DataColumn(S"Item", Type::GetType(S"System.Int32"),S"");
    t->Columns->Add(c1);
    t->Columns->Add(c2);

    // DataColumn array to set primary key.
    DataColumn* keyCol[]= new DataColumn*[1];

    // Set primary key column.
    keyCol[0]= c1;
    t->PrimaryKey=keyCol;

    // Add a RowChanged event handler for the table.
    t->RowChanged += new DataRowChangeEventHandler(this, &Form1::Row_Changed);

    // Add ten rows.
    for(int i = 0; i <10;i++){
       DataRow* r=t->NewRow();
       r->Item[S"id"] = __box(i);
       r->Item[S"Item"]= __box(i);
       t->Rows->Add(r);
    }
    // Accept changes.
    ds->AcceptChanges();

    PrintValues(ds, S"Original values");

    // Create a second DataTable identical to the first.
    DataTable* t2 = t->Clone();

    // Add three rows. Note that the id column can't be the
    // same as existing rows in the DataSet table.
    DataRow* newRow;
    newRow = t2->NewRow();
    newRow->Item[S"id"] = __box(14);
    newRow->Item[S"item"] = __box(774);

    //Note the alternative method for adding rows.

    Object* temp0 [] = {__box(12), __box(555)};
    t2->Rows->Add(temp0);

    Object* temp1 [] = {__box(13), __box(665)};
    t2->Rows->Add(temp1);

    // Merge the table into the DataSet
    Console::WriteLine(S"Merging");
    ds->Merge(t2);
    PrintValues(ds, S"Merged With table.");

 }
 
 void Row_Changed(Object* /*sender*/, DataRowChangeEventArgs* e){
    Console::WriteLine(S"Row Changed {0}\t{1}", __box(e->Action), e->Row->ItemArray[0]);
 }
 
 void PrintValues(DataSet* ds, String* label){
    Console::WriteLine(S"\n{0}", label);
    System::Collections::IEnumerator* myEnum = ds->Tables->GetEnumerator();
    while (myEnum->MoveNext())
    {
       DataTable* t = __try_cast<DataTable*>(myEnum->Current);
       Console::WriteLine(S"TableName: {0}", t->TableName);
       System::Collections::IEnumerator* myEnum1 = t->Rows->GetEnumerator();
       while (myEnum1->MoveNext())
       {
          DataRow* r = __try_cast<DataRow*>(myEnum1->Current);
          System::Collections::IEnumerator* myEnum2 = t->Columns->GetEnumerator();
          while (myEnum2->MoveNext())
          {
             DataColumn* c = __try_cast<DataColumn*>(myEnum2->Current);
             Console::Write(S"\t {0}", r->Item[c] );
          }
          Console::WriteLine();
       }
    }
 }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

DataSet クラス | DataSet メンバ | System.Data 名前空間 | DataSet.Merge オーバーロードの一覧 | DataTable

次の方法で共有

DataSet.Merge メソッド (DataTable)

パラメータ

例外

解説

使用例

必要条件

参照

その他のリソース