ApplyChanges Método (IEnumerable(String), DataSet, SyncAnchor)

Artículo
08/18/2010

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: