Método ApplyChanges (SyncGroupMetadata, DataSet, SyncSession)
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 metadados de grupo, conjunto de dados e sessão de sincronização.
Namespace: Microsoft.Synchronization.Data.SqlServerCe
Assembly: Microsoft.Synchronization.Data.SqlServerCe (em Microsoft.Synchronization.Data.SqlServerCe.dll)
Sintaxe
'Declaração
Public Overrides Function ApplyChanges ( _
groupMetadata As SyncGroupMetadata, _
dataSet As DataSet, _
syncSession As SyncSession _
) As SyncContext
'Uso
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
Parâmetros
- groupMetadata
Tipo: Microsoft.Synchronization.Data. . :: . .SyncGroupMetadata
Um objeto SyncGroupMetadata que contém metadados sobre o grupo de sincronização.
- dataSet
Tipo: System.Data. . :: . .DataSet
Um objeto DataSet que contém as linhas de dados a serem aplicadas ao banco de dados do cliente.
- syncSession
Tipo: Microsoft.Synchronization.Data. . :: . .SyncSession
Um objeto SyncSession que contém metadados sobre a sessão de sincronização atual.
Valor de retorno
Tipo: Microsoft.Synchronization.Data. . :: . .SyncContext
Um objeto SyncContext que contém alterações de dados, valores de âncora e outros metadados para uma sessão de sincronização.
Exceções
Exceção | Condição |
---|---|
ArgumentNullException | groupMetadata ou dataSet é um null Nothing nullptr unit uma referência nula (Nothing no Visual Basic) . |
DataSyncException | Outra transação está em andamento. |
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, a seguinte ordem de processamento será usada 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
SqlCeClientSyncProvider Classe