DataSet.Merge メソッド (DataSet)
指定した DataSet およびそのスキーマを現在の DataSet にマージします。
Overloads Public Sub Merge( _
ByVal dataSet As DataSet _)
[C#]
public void Merge(DataSetdataSet);
[C++]
public: void Merge(DataSet* dataSet);
[JScript]
public function Merge(
dataSet : DataSet);
パラメータ
- dataSet
マージするデータとスキーマが格納されている DataSet 。
例外
| 例外の種類 | 条件 |
|---|---|
| ConstraintException | 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 メソッドが呼び出されたときは、スキーマが変更されている可能性があるため、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++] DataSet で GetChanges 、Update、 Merge の各メソッドを使用する例を次に示します。
Private Sub DemonstrateMerge()
' 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 columns to table, and table to DataSet.
t.Columns.Add(c1)
t.Columns.Add(c2)
ds.Tables.Add(t)
' 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 two 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
PrintValues(xSet, "Reconciled subset values")
' Merge changes back to first DataSet.
ds.Merge(xSet)
PrintValues(ds, "Merged Values")
End If
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 DemonstrateMerge() {
// 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 columns to table, and table to DataSet.
t.Columns.Add(c1);
t.Columns.Add(c2);
ds.Tables.Add(t);
// 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 two 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();
}
}
}
}
PrintValues(xSet, "Reconciled subset values");
// Merge changes back to first DataSet.
ds.Merge(xSet);
PrintValues(ds, "Merged Values");
}
}
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 DemonstrateMerge() {
// 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 columns to table, and table to DataSet.
t->Columns->Add(c1);
t->Columns->Add(c2);
ds->Tables->Add(t);
// 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 two 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();
}
}
}
}
PrintValues(xSet, S"Reconciled subset values");
// Merge changes back to first DataSet.
ds->Merge(xSet);
PrintValues(ds, S"Merged Values");
}
}
void PrintValues(DataSet* ds, String* label){
Console::WriteLine(S"\n{0}", label);
System::Collections::IEnumerator* myEnum2 = ds->Tables->GetEnumerator();
while (myEnum2->MoveNext())
{
DataTable* t = __try_cast<DataTable*>(myEnum2->Current);
Console::WriteLine(S"TableName: {0}", t->TableName);
System::Collections::IEnumerator* myEnum3 = t->Rows->GetEnumerator();
while (myEnum3->MoveNext())
{
DataRow* r = __try_cast<DataRow*>(myEnum3->Current);
System::Collections::IEnumerator* myEnum4 = t->Columns->GetEnumerator();
while (myEnum4->MoveNext())
{
DataColumn* c = __try_cast<DataColumn*>(myEnum4->Current);
Console::Write(S"\t {0}", r->Item[c] );
}
Console::WriteLine();
}
}
}
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン .gif)
をクリックします。
必要条件
プラットフォーム: 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 オーバーロードの一覧 | ForeignKeyConstraint | GetChanges | UniqueConstraint