Método SqlCeClientSyncProvider.ApplyChanges (String, DataSet, SyncAnchor)

Artigo
10/17/2009

Aplica inserções, atualizações e exclusões para um grupo de sincronização no banco de dados cliente quando são especificados parâmetros de nome de tabela, conjunto de dados e âncora do servidor.

Namespace: Microsoft.Synchronization.Data.SqlServerCe
Assembly: Microsoft.Synchronization.Data.SqlServerCe (em microsoft.synchronization.data.sqlserverce.dll)

Sintaxe

'Declaração
<SuppressMessageAttribute("Microsoft.Naming", "CA1702:CompoundWordsShouldBeCasedCorrectly")> _
Public Function ApplyChanges ( _
    tableName As String, _
    dataSet As DataSet, _
    serverAnchor As SyncAnchor _
) As SyncContext
'Uso
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

Parâmetros

tableName
Uma tabela no banco de dados cliente para a qual aplicar alterações.

dataSet
Um objeto DataSet que contém as linhas de dados a serem aplicadas ao banco de dados.

serverAnchor
Um objeto SyncAnchor que representa o valor NewAnchor para esta sessão de sincronização.

Valor de retorno

Um objeto SyncContext que contém alterações de dados, valores de âncora e outros metadados para uma sessão de sincronização.

Comentários

Este método pressupõe que a tabela esteja no banco de dados do cliente; caso contrário, ele lançará uma exceção. Se a tabela existir mas o controle não estiver habilitado, o controle bidirecional será habilitado. As linhas são marcadas com um valor DataRowState para diferenciar inserções, atualizações e exclusões.

As alterações são aplicadas na seguinte ordem: exclusões, inserções e atualizações. A ordem na qual as alterações são aplicadas a cada tabela no grupo de sincronização depende da ordem na qual as tabelas são adicionadas ao grupo. As exclusões são aplicadas na ordem inversa à qual as tabelas são adicionadas. As inserções e as atualizações são aplicadas na ordem na qual as tabelas são adicionadas.

Por exemplo, se você adicionar a tabela SalesOrderHeader e depois adicionar SalesOrderDetail ao mesmo grupo de sincronização, será usada a seguinte ordem de processamento durante a sincronização:

As exclusões são aplicadas a SalesOrderDetail e depois a SalesOrderHeader.
As inserções são aplicadas a SalesOrderHeader e depois a SalesOrderDetail.
As atualizações são aplicadas a SalesOrderHeader e depois a SalesOrderDetail.

Consulte também

Referência

Classe SqlCeClientSyncProvider
Membros SqlCeClientSyncProvider
Namespace Microsoft.Synchronization.Data.SqlServerCe

Compartilhar via