ApplyChanges Método (String, DataSet, SyncAnchor)

Artículo
08/18/2010

Aplica a la base de datos cliente las inserciones, actualizaciones y eliminaciones para un grupo de sincronización cuando se dan los siguientes parámetros: nombre de tabla, conjunto de datos y delimitador de servidor.

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

Sintaxis

'Declaración
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)

public SyncContext ApplyChanges(
    string tableName,
    DataSet dataSet,
    SyncAnchor serverAnchor
)

public:
SyncContext^ ApplyChanges(
    String^ tableName, 
    DataSet^ dataSet, 
    SyncAnchor^ serverAnchor
)

member ApplyChanges : 
        tableName:string * 
        dataSet:DataSet * 
        serverAnchor:SyncAnchor -> SyncContext

public function ApplyChanges(
    tableName : String, 
    dataSet : DataSet, 
    serverAnchor : SyncAnchor
) : SyncContext

Parámetros

tableName
Tipo: System. . :: . .String
Tabla de la base de datos cliente en la que aplicar cambios.

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

serverAnchor
Tipo: Microsoft.Synchronization.Data. . :: . .SyncAnchor
Objeto SyncAnchor que representa el valor NewAnchor para esta sesión 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	tableName 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: