ApplyChanges メソッド (SyncGroupMetadata, DataSet, SyncSession)
グループ メタデータ、データセット、および同期セッション パラメーターが指定されている場合に、同期グループに対する挿入、更新、および削除をクライアント データベースに適用します。
名前空間: Microsoft.Synchronization.Data.SqlServerCe
アセンブリ: Microsoft.Synchronization.Data.SqlServerCe (Microsoft.Synchronization.Data.SqlServerCe.dll 内)
構文
'宣言
Public Overrides Function ApplyChanges ( _
groupMetadata As SyncGroupMetadata, _
dataSet As DataSet, _
syncSession As SyncSession _
) As SyncContext
'使用
Dim instance As SqlCeClientSyncProvider
Dim groupMetadata As SyncGroupMetadata
Dim dataSet As DataSet
Dim syncSession As SyncSession
Dim returnValue As SyncContext
returnValue = instance.ApplyChanges(groupMetadata, _
dataSet, syncSession)
public override SyncContext ApplyChanges(
SyncGroupMetadata groupMetadata,
DataSet dataSet,
SyncSession syncSession
)
public:
virtual SyncContext^ ApplyChanges(
SyncGroupMetadata^ groupMetadata,
DataSet^ dataSet,
SyncSession^ syncSession
) override
abstract ApplyChanges :
groupMetadata:SyncGroupMetadata *
dataSet:DataSet *
syncSession:SyncSession -> SyncContext
override ApplyChanges :
groupMetadata:SyncGroupMetadata *
dataSet:DataSet *
syncSession:SyncSession -> SyncContext
public override function ApplyChanges(
groupMetadata : SyncGroupMetadata,
dataSet : DataSet,
syncSession : SyncSession
) : SyncContext
パラメーター
- groupMetadata
型 : Microsoft.Synchronization.Data. . :: . .SyncGroupMetadata
同期グループに関するメタデータを格納する SyncGroupMetadata オブジェクト。
- dataSet
型 : System.Data. . :: . .DataSet
クライアント データベースに適用するデータ行を格納する DataSet オブジェクト。
- syncSession
型 : Microsoft.Synchronization.Data. . :: . .SyncSession
現在の同期セッションに関するメタデータを格納する SyncSession オブジェクト。
戻り値
型 : Microsoft.Synchronization.Data. . :: . .SyncContext
同期セッションのデータ変更、およびアンカー値などのメタデータを格納する SyncContext オブジェクト。
例外
例外 | 条件 |
---|---|
ArgumentNullException | groupMetadata または dataSet が null Nothing nullptr unit NULL 参照 (Visual Basic では Nothing) です。 |
DataSyncException | 別のトランザクションが進行中です。 |
説明
このメソッドは、テーブルがクライアント データベース内にあることを前提としています。それ以外の場合は、例外がスローされます。テーブルが存在しても追跡が無効になっている場合は、双方向の追跡が有効です。行は、挿入、更新、および削除を区別する DataRowState 値でマークされています。
変更は、削除、挿入、更新の順で適用されます。同期グループ内の各テーブルに変更が適用される順序は、テーブルがグループに追加される順序によって決まります。削除の適用順序は、テーブルの追加順序とは逆になります。挿入と更新の適用順序は、テーブルの追加順序と同じになります。
たとえば、テーブル SalesOrderHeader を追加し、次に SalesOrderDetail を同じ同期グループに追加した場合、同期は次の順序で処理されます。
削除は、SalesOrderDetail、SalesOrderHeader の順に適用されます。
挿入は、SalesOrderHeader、SalesOrderDetail の順に適用されます。
更新は、SalesOrderHeader、SalesOrderDetail の順に適用されます。