DataSet.Merge メソッド (DataSet, Boolean, MissingSchemaAction)

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

指定した DataSet およびそのスキーマを現在の DataSet にマージします。指定した引数に従って、この DataSet に行われた変更を保持または破棄し、互換性のないスキーマを処理します。

Overloads Public Sub Merge( _
   ByVal dataSet As DataSet, _   ByVal preserveChanges As Boolean, _   ByVal missingSchemaAction As MissingSchemaAction _)
[C#]
public void Merge(DataSetdataSet,boolpreserveChanges,MissingSchemaActionmissingSchemaAction);
[C++]
public: void Merge(DataSet* dataSet,boolpreserveChanges,MissingSchemaActionmissingSchemaAction);
[JScript]
public function Merge(
   dataSet : DataSet,preserveChanges : Boolean,missingSchemaAction : MissingSchemaAction);

パラメータ

dataSet
マージするデータとスキーマが格納されている DataSet 。
preserveChanges
現在の DataSet に対して行われた変更を保持するには true 。保持しない場合は false 。
missingSchemaAction
MissingSchemaAction 値の 1 つ。

例外

例外の種類	条件
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 メソッドを説明するため、現在の DataSet を "ターゲット"、2 番目の (パラメータ) DataSet を "ソース" と呼ぶことにします。ターゲット DataSet はアクション (マージ) の対象であるため、それに応じた名前になります。2 番目の DataSet に含まれる情報は変化せず、現在の 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 を作成する例を次に示します。2 つの値を変更し、1 行追加します。変更されたデータのサブセットは、 GetChanges メソッドを使用して作成されます。エラーを調整した後、新しい列をサブセットに追加し、スキーマを変更します。 missingSchemaAction を MissingSchemaAction.Add に設定して Merge メソッドを呼び出すと、元の DataSet オブジェクトのスキーマに新しい列が追加されます。

 
Private Sub DemonstrateMergeMissingSchema()
    ' Create a DataSet with one table, two columns, and three rows.
    Dim ds As New DataSet("myDataSet")
    Dim t As New DataTable("Items")
    Dim c1 As New DataColumn("id", Type.GetType("System.Int32"))
    c1.AutoIncrement = True
    Dim c2 As New DataColumn("Item", Type.GetType("System.Int32"))
    ' DataColumn array to set primary key.
    Dim keyCol(1) As DataColumn
    Dim r As DataRow
    ' Create variable for temporary DataSet. 
    Dim xSet As DataSet
    ' Add RowChanged event handler for the table.
    AddHandler t.RowChanged, AddressOf Row_Changed
    ds.Tables.Add(t)
    t.Columns.Add(c1)
    t.Columns.Add(c2)
    ' Set primary key column.
    keyCol(0) = c1
    t.PrimaryKey = keyCol
    ' Add ten rows.
    Dim i As Integer
    For i = 0 To 9
        r = t.NewRow()
        r("Item") = i
         t.Rows.Add(r)
    Next i
    ' Accept changes.
    ds.AcceptChanges()
    PrintValues(ds, "Original values")
    ' Change row values.
    t.Rows(0)("Item") = 50
    t.Rows(1)("Item") = 111
    ' Add one row.
    r = t.NewRow()
    r("Item") = 74
    t.Rows.Add(r)
    ' Insert code for error checking. Here we set one row in error.
    t.Rows(1).RowError = "over 100"
    PrintValues(ds, "Modified and New Values")
    ' If the table has changes or errors, create a subset DataSet.
    If ds.HasChanges(DataRowState.Modified Or DataRowState.Added) _
       And ds.HasErrors Then
        ' Use GetChanges to extract subset.
        xSet = ds.GetChanges(DataRowState.Modified Or DataRowState.Added)
        PrintValues(xSet, "Subset values")
        ' Insert code to reconcile errors. In this case, we'll reject changes.
        Dim xTable As DataTable
        For Each xTable In  xSet.Tables
            If xTable.HasErrors Then
                Dim xRow As DataRow
                For Each xRow In  xTable.Rows
                    'Console.WriteLine(xRow["Item"]);
                    If CInt(xRow("Item", DataRowVersion.Current)) > 100 Then
                        xRow.RejectChanges()
                        xRow.ClearErrors()
                    End If
                Next xRow
            End If
        Next xTable
        ' Add a column to the xSet. This changes the schema.
        xSet.Tables("Items").Columns.Add(New DataColumn("newColumn"))
        PrintValues(xSet, "Reconciled subset values")
        ' Add values to the rows for each column.
        Dim myRow As DataRow
        For Each myRow In  xSet.Tables("Items").Rows
            myRow("newColumn") = "my new schema value"
        Next myRow
        ' Merge changes back to first DataSet.
        ds.Merge(xSet, False, System.Data.MissingSchemaAction.Add)
    End If
    PrintValues(ds, "Merged Values")
End Sub
   
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

Private Sub PrintValues(ds As DataSet, label As String)
    Console.WriteLine(ControlChars.Cr + label)
    Dim t As DataTable
    For Each t In  ds.Tables
        Console.WriteLine("TableName: " + t.TableName)
        Dim r As DataRow
        For Each r In  t.Rows
            Dim c As DataColumn
            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 DemonstrateMergeMissingSchema(){
   // Create a DataSet with one table, two columns, and three rows.
   DataSet ds = new DataSet("myDataSet");
   DataTable t = new DataTable("Items");
   DataColumn c1 = new DataColumn("id", Type.GetType("System.Int32"));
   c1.AutoIncrement=true;
   DataColumn c2 = new DataColumn("Item", Type.GetType("System.Int32"));
   // DataColumn array to set primary key.
   DataColumn[] keyCol= new DataColumn[1];
   DataRow r;
   // Create variable for temporary DataSet. 
   DataSet xSet;
   // Add RowChanged event handler for the table.
   t.RowChanged+= new DataRowChangeEventHandler(Row_Changed);
   ds.Tables.Add(t);
   t.Columns.Add(c1);
   t.Columns.Add(c2);
   // Set primary key column.
   keyCol[0]= c1;
   t.PrimaryKey=keyCol;
   // Add ten rows.
   for(int i = 0; i <10;i++){
      r=t.NewRow();
      r["Item"]= i;
      t.Rows.Add(r);
   }
   // Accept changes.
   ds.AcceptChanges();
   PrintValues(ds, "Original values");
   // Change row values.
   t.Rows[0]["Item"]= 50;
   t.Rows[1]["Item"]= 111;
   // Add one row.
   r=t.NewRow();
   r["Item"]=74;
   t.Rows.Add(r);
   // Insert code for error checking. Here we set one row in error.
   t.Rows[1].RowError= "over 100";
   PrintValues(ds, "Modified and New Values");
   // If the table has changes or errors, create a subset DataSet.
   if(ds.HasChanges(DataRowState.Modified | DataRowState.Added)& ds.HasErrors){
      // Use GetChanges to extract subset.
      xSet = ds.GetChanges(DataRowState.Modified|DataRowState.Added);
      PrintValues(xSet, "Subset values");
      // Insert code to reconcile errors. In this case, we'll reject changes.
      foreach(DataTable xTable in xSet.Tables){
         if (xTable.HasErrors){
            foreach(DataRow xRow in xTable.Rows){
               //Console.WriteLine(xRow["Item"]);
                  if((int)xRow["Item",DataRowVersion.Current ]> 100){
                  xRow.RejectChanges();
                  xRow.ClearErrors();
               }
            }
         }
      }
      // Add a column to the xSet. This changes the schema.
      xSet.Tables["Items"].Columns.Add(new DataColumn("newColumn"));
      PrintValues(xSet, "Reconciled subset values");
      // Add values to the rows for each column.
      foreach(DataRow myRow in xSet.Tables["Items"].Rows){
         myRow["newColumn"] = "my new schema value";
      }
      // Merge changes back to first DataSet.
      ds.Merge(xSet,false,System.Data.MissingSchemaAction.Add);
   }
   PrintValues(ds, "Merged Values");
}

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 DemonstrateMergeMissingSchema(){
    // Create a DataSet with one table, two columns, and three rows.
    DataSet* ds = new DataSet(S"myDataSet");
    DataTable* t = new DataTable(S"Items");
    DataColumn* c1 = new DataColumn(S"id", Type::GetType(S"System.Int32"));
    c1->AutoIncrement=true;
    DataColumn* c2 = new DataColumn(S"Item", Type::GetType(S"System.Int32"));
    // DataColumn array to set primary key.
    DataColumn* keyCol[]= new DataColumn*[1];
    DataRow* r;
    // Create variable for temporary DataSet. 
    DataSet* xSet;
    // Add RowChanged event handler for the table.
    t->RowChanged+= new DataRowChangeEventHandler(this, &Form1::Row_Changed);
    ds->Tables->Add(t);
    t->Columns->Add(c1);
    t->Columns->Add(c2);
    // Set primary key column.
    keyCol[0]= c1;
    t->PrimaryKey=keyCol;
    // Add ten rows.
    for(int i = 0; i <10;i++){
       r=t->NewRow();
       r->Item[S"Item"]= __box(i);
       t->Rows->Add(r);
    }
    // Accept changes.
    ds->AcceptChanges();
    PrintValues(ds, S"Original values");
    // Change row values.
    t->Rows->Item[0]->Item[S"Item"]= __box(50);
    t->Rows->Item[1]->Item[S"Item"]= __box(111);
    // Add one row.
    r=t->NewRow();
    r->Item[S"Item"]=__box(74);
    t->Rows->Add(r);
    // Insert code for error checking. Here we set one row in error.
    t->Rows->Item[1]->RowError= S"over 100";
    PrintValues(ds, S"Modified and New Values");
    // If the table has changes or errors, create a subset DataSet.
    if(ds->HasChanges(static_cast<DataRowState>(DataRowState::Modified | DataRowState::Added))& ds->HasErrors){
       // Use GetChanges to extract subset.
       xSet = ds->GetChanges(static_cast<DataRowState>(DataRowState::Modified|DataRowState::Added));
       PrintValues(xSet, S"Subset values");
       // Insert code to reconcile errors. In this case, we'll reject changes.
       System::Collections::IEnumerator* myEnum = xSet->Tables->GetEnumerator();
       while (myEnum->MoveNext())
       {
          DataTable* xTable = __try_cast<DataTable*>(myEnum->Current);
          if (xTable->HasErrors){
             System::Collections::IEnumerator* myEnum1 = xTable->Rows->GetEnumerator();
             while (myEnum1->MoveNext())
             {
                DataRow* xRow = __try_cast<DataRow*>(myEnum1->Current);
                //Console.WriteLine(xRow["Item"]);
                   if(*__try_cast<Int32*>(xRow->get_Item(S"Item",DataRowVersion::Current)) > 100){
                   xRow->RejectChanges();
                   xRow->ClearErrors();
                }
             }
          }
       }
       // Add a column to the xSet. This changes the schema.
       xSet->Tables->Item[S"Items"]->Columns->Add(new DataColumn(S"newColumn"));
       PrintValues(xSet, S"Reconciled subset values");
       // Add values to the rows for each column.
       System::Collections::IEnumerator* myEnum2 = xSet->Tables->Item[S"Items"]->Rows->GetEnumerator();
       while (myEnum2->MoveNext())
       {
          DataRow* myRow = __try_cast<DataRow*>(myEnum2->Current);
          myRow->Item[S"newColumn"] = S"my new schema value";
       }
       // Merge changes back to first DataSet.
       ds->Merge(xSet,false,System::Data::MissingSchemaAction::Add);
    }
    PrintValues(ds, S"Merged Values");
 }
 
 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* myEnum3 = ds->Tables->GetEnumerator();
    while (myEnum3->MoveNext())
    {
       DataTable* t = __try_cast<DataTable*>(myEnum3->Current);
       Console::WriteLine(S"TableName: {0}", t->TableName);
       System::Collections::IEnumerator* myEnum4 = t->Rows->GetEnumerator();
       while (myEnum4->MoveNext())
       {
          DataRow* r = __try_cast<DataRow*>(myEnum4->Current);
          System::Collections::IEnumerator* myEnum5 = t->Columns->GetEnumerator();
          while (myEnum5->MoveNext())
          {
             DataColumn* c = __try_cast<DataColumn*>(myEnum5->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 オーバーロードの一覧

次の方法で共有

DataSet.Merge メソッド (DataSet, Boolean, MissingSchemaAction)

パラメータ

例外

解説

使用例

必要条件

参照

その他のリソース