ApplyChanges Método (IEnumerable(String), DataSet, SyncAnchor)
Aplica inserciones, actualizaciones y eliminaciones a la base de datos cliente para un grupo de sincronización cuando se dan los siguientes parámetros: nombres de tablas, 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 ( _
tableNames As IEnumerable(Of String), _
dataSet As DataSet, _
serverAnchor As SyncAnchor _
) As SyncContext
'Uso
Dim instance As SqlCeClientSyncProvider
Dim tableNames As IEnumerable(Of String)
Dim dataSet As DataSet
Dim serverAnchor As SyncAnchor
Dim returnValue As SyncContext
returnValue = instance.ApplyChanges(tableNames, _
dataSet, serverAnchor)
public SyncContext ApplyChanges(
IEnumerable<string> tableNames,
DataSet dataSet,
SyncAnchor serverAnchor
)
public:
SyncContext^ ApplyChanges(
IEnumerable<String^>^ tableNames,
DataSet^ dataSet,
SyncAnchor^ serverAnchor
)
member ApplyChanges :
tableNames:IEnumerable<string> *
dataSet:DataSet *
serverAnchor:SyncAnchor -> SyncContext
public function ApplyChanges(
tableNames : IEnumerable<String>,
dataSet : DataSet,
serverAnchor : SyncAnchor
) : SyncContext
Parámetros
- tableNames
Tipo: System.Collections.Generic. . :: . .IEnumerable< (Of < ( <'String> ) > ) >
Colección de tablas en la base de datos cliente a las 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 DataRowState para distinguir entre inserciones, actualizaciones y 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:
Las eliminaciones se aplican a SalesOrderDetail y después a SalesOrderHeader.
Las inserciones se aplican a SalesOrderHeader y después a SalesOrderDetail.
Las actualizaciones se aplican a SalesOrderHeader y después a SalesOrderDetail.
Vea también
Referencia
SqlCeClientSyncProvider Miembros
Microsoft.Synchronization.Data.SqlServerCe Espacio de nombres