ApplyChanges Método (SyncGroupMetadata, DataSet, SyncSession)

Artículo
08/18/2010

Aplica inserciones, actualizaciones y eliminaciones para un grupo de sincronización en la base de datos cliente cuando se dan los siguientes parámetros: metadatos de grupo, conjunto de datos y sesión de sincronización.

Espacio de nombres: Microsoft.Synchronization.Data.SqlServerCe
Ensamblado: Microsoft.Synchronization.Data.SqlServerCe (en Microsoft.Synchronization.Data.SqlServerCe.dll)

Sintaxis

'Declaración
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
Objeto SyncGroupMetadata que contiene metadatos del grupo de sincronización.

dataSet
Tipo: System.Data. . :: . .DataSet
Objeto DataSet que contiene las filas de datos que se aplicarán a la base de datos cliente.

syncSession
Tipo: Microsoft.Synchronization.Data. . :: . .SyncSession
Objeto SyncSession que contiene metadatos sobre la sesión actual de sincronización.

Valor devuelto

Tipo: Microsoft.Synchronization.Data. . :: . .SyncContext
Objeto SyncContext que contiene cambios de datos, así como valores de delimitador y otros metadatos correspondientes a una sesión de sincronización.

Excepciones

Excepción	Condición
ArgumentNullException	groupMetadata o dataSet es un valor null Nothing nullptr unit es una referencia NULL (Nothing en Visual Basic). .
DataSyncException	Hay otra transacción en curso.

Notas

En este método se supone que la tabla está en la base de datos cliente. En caso contrario, el método produce una excepción. Cuando la tabla existe y el seguimiento no está habilitado, se habilita el seguimiento bidireccional. Las filas se marcan con un valor DataRowState para diferenciar las inserciones, las actualizaciones y las eliminaciones.

Los cambios se aplican en el siguiente orden: eliminaciones, inserciones y, por último, actualizaciones. El orden de aplicación de cambios sobre cada tabla en un grupo de sincronización depende del orden en el que se agregaron las tablas a dicho grupo. Las eliminaciones se aplican en el orden inverso al orden en el que han agregado las tablas. Las inserciones y actualizaciones se aplican en el mismo orden en el que se han agregado las tablas.

Por ejemplo, si se agrega la tabla SalesOrderHeader y se agrega a continuación SalesOrderDetail al mismo grupo de sincronización, se utilizará el siguiente orden de procesamiento durante la sincronización: