Метод SqlCeClientSyncProvider.ApplyChanges (String, DataSet, SyncAnchor)

Статья
10/17/2009

Применяет операции вставки, обновления и удаления для группы синхронизации в клиентской базе данных по заданному имени таблицы, набору данных и параметрам серверной точки привязки.

Пространство имен: Microsoft.Synchronization.Data.SqlServerCe
Сборка: Microsoft.Synchronization.Data.SqlServerCe (в microsoft.synchronization.data.sqlserverce.dll)

Синтаксис

'Декларация
<SuppressMessageAttribute("Microsoft.Naming", "CA1702:CompoundWordsShouldBeCasedCorrectly")> _
Public Function ApplyChanges ( _
    tableName As String, _
    dataSet As DataSet, _
    serverAnchor As SyncAnchor _
) As SyncContext
'Применение
Dim instance As SqlCeClientSyncProvider
Dim tableName As String
Dim dataSet As DataSet
Dim serverAnchor As SyncAnchor
Dim returnValue As SyncContext

returnValue = instance.ApplyChanges(tableName, dataSet, serverAnchor)

[SuppressMessageAttribute("Microsoft.Naming", "CA1702:CompoundWordsShouldBeCasedCorrectly")] 
public SyncContext ApplyChanges (
    string tableName,
    DataSet dataSet,
    SyncAnchor serverAnchor
)

[SuppressMessageAttribute(L"Microsoft.Naming", L"CA1702:CompoundWordsShouldBeCasedCorrectly")] 
public:
SyncContext^ ApplyChanges (
    String^ tableName, 
    DataSet^ dataSet, 
    SyncAnchor^ serverAnchor
)

/** @attribute SuppressMessageAttribute("Microsoft.Naming", "CA1702:CompoundWordsShouldBeCasedCorrectly") */ 
public SyncContext ApplyChanges (
    String tableName, 
    DataSet dataSet, 
    SyncAnchor serverAnchor
)

SuppressMessageAttribute("Microsoft.Naming", "CA1702:CompoundWordsShouldBeCasedCorrectly") 
public function ApplyChanges (
    tableName : String, 
    dataSet : DataSet, 
    serverAnchor : SyncAnchor
) : SyncContext

Параметры

tableName
Таблица в клиентской базе данных, к которой необходимо применить изменения.

dataSet
Объект DataSet, содержащий строки данных, которые будут применены к базе данных.

serverAnchor
Объект SyncAnchor, представляющий значение NewAnchor для этого сеанса синхронизации.

Возвращаемое значение

Объект SyncContext, содержащий изменения данных, значения точек привязки и другие метаданные сеанса синхронизации.

Замечания

Этот метод предполагает, что таблица находится в клиентской базе данных. В противном случае возникнет исключение. Если таблица существует, но для нее не включено отслеживание, включается двунаправленное отслеживание. Строки помечаются значением перечисления DataRowState, что позволяет различать операции вставки, обновления и удаления.

Изменения применяются в следующем порядке: операции удаления, вставки, а затем обновления. Порядок, в котором изменения применяются к каждой из таблиц в группе синхронизации, зависит от порядка, в котором таблицы добавлялись в эту группу. Операции удаления применяются в порядке, обратном порядку добавления таблиц. Операции вставки и обновления выполняются в том же порядке, в котором добавлялись таблицы.

Например, если добавить в некоторую группу синхронизации таблицу SalesOrderHeader, а затем добавить в ту же группу таблицу SalesOrderDetail, то в процессе синхронизации будет применяться следующий порядок обработки.

Операции удаления применяются сначала к таблице SalesOrderDetail, а затем к таблице SalesOrderHeader.
Операции вставки применяются сначала к таблице SalesOrderHeader, а затем к таблице SalesOrderDetail.
Операции обновления применяются сначала к таблице SalesOrderHeader, а затем к таблице SalesOrderDetail.

См. также

Справочник

Класс SqlCeClientSyncProvider
Элементы SqlCeClientSyncProvider
Пространство имен Microsoft.Synchronization.Data.SqlServerCe

Поделиться через