ApplyChanges 方法 (IEnumerable(String), DataSet, SyncAnchor)
命名空间: Microsoft.Synchronization.Data.SqlServerCe
程序集: Microsoft.Synchronization.Data.SqlServerCe(在 Microsoft.Synchronization.Data.SqlServerCe.dll 中)
语法
声明
Public Function ApplyChanges ( _
tableNames As IEnumerable(Of String), _
dataSet As DataSet, _
serverAnchor As SyncAnchor _
) As SyncContext
用法
Dim instance As SqlCeClientSyncProvider
Dim tableNames As IEnumerable(Of String)
Dim dataSet As DataSet
Dim serverAnchor As SyncAnchor
Dim returnValue As SyncContext
returnValue = instance.ApplyChanges(tableNames, _
dataSet, serverAnchor)
public SyncContext ApplyChanges(
IEnumerable<string> tableNames,
DataSet dataSet,
SyncAnchor serverAnchor
)
public:
SyncContext^ ApplyChanges(
IEnumerable<String^>^ tableNames,
DataSet^ dataSet,
SyncAnchor^ serverAnchor
)
member ApplyChanges :
tableNames:IEnumerable<string> *
dataSet:DataSet *
serverAnchor:SyncAnchor -> SyncContext
public function ApplyChanges(
tableNames : IEnumerable<String>,
dataSet : DataSet,
serverAnchor : SyncAnchor
) : SyncContext
参数
- tableNames
类型:System.Collections.Generic. . :: . .IEnumerable< (Of < ( <'String> ) > ) >
要应用变更的客户端数据库中表的集合。
- dataSet
类型:System.Data. . :: . .DataSet
一个 DataSet 对象,包含要应用于数据库的数据行。
- serverAnchor
类型:Microsoft.Synchronization.Data. . :: . .SyncAnchor
表示此同步会话的 NewAnchor 值的 SyncAnchor 对象。
返回值
类型:Microsoft.Synchronization.Data. . :: . .SyncContext
包含同步会话的数据变更、定位点值和其他元数据的 SyncContext 对象。
异常
异常 | 条件 |
---|---|
ArgumentNullException | tableName 或 dataSet 为 null Nothing nullptr unit null 引用(在 Visual Basic 中为 Nothing) 。 |
DataSyncException | 另一个事务正在进行中。 |
注释
此方法假定表位于客户端数据库中;否则,此方法将引发异常。如果表存在,但未启用跟踪,则会启用双向跟踪。各行将由一个 DataRowState 来标记,以区分是插入、更新还是删除。
按以下顺序应用变更:先删除,再插入,最后更新。将变更应用于同步组中每个表的顺序取决于将表添加到组中的顺序。应用删除的顺序与添加表的顺序相反。应用插入和更新的顺序与添加表的顺序相同。
例如,如果您先后将表 SalesOrderHeader 和 SalesOrderDetail 添加到同一同步组中,则同步期间将使用以下处理顺序:
删除应用于 SalesOrderDetail,然后应用于 SalesOrderHeader。
插入应用于 SalesOrderHeader,然后应用于 SalesOrderDetail。
更新应用于 SalesOrderHeader,然后应用于 SalesOrderDetail。