ApplyChanges méthode (IEnumerable(String), DataSet, SyncAnchor)

Article
08/18/2010

Applique les insertions, mises à jour et suppressions pour un groupe de synchronisation à la base de données client en fonction des noms de tables, d'un jeu de données et des paramètres d'ancre de serveur.

Espace de noms : Microsoft.Synchronization.Data.SqlServerCe
Assembly : Microsoft.Synchronization.Data.SqlServerCe (dans Microsoft.Synchronization.Data.SqlServerCe.dll)

Syntaxe

'Déclaration
Public Function ApplyChanges ( _
    tableNames As IEnumerable(Of String), _
    dataSet As DataSet, _
    serverAnchor As SyncAnchor _
) As SyncContext
'Utilisation
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

Paramètres

tableNames
Type : System.Collections.Generic. . :: . .IEnumerable< (Of < ( <'String> ) > ) >
Collection de tables dans la base de données client pour laquelle appliquer les modifications.

dataSet
Type : System.Data. . :: . .DataSet
Objet DataSet qui contient les lignes de données à appliquer à la base de données.

serverAnchor
Type : Microsoft.Synchronization.Data. . :: . .SyncAnchor
Objet SyncAnchor qui représente la valeur NewAnchor pour cette session de synchronisation.

Valeur de retour

Type : Microsoft.Synchronization.Data. . :: . .SyncContext
Objet SyncContext qui contient des modifications de données, des valeurs d'ancre et d'autres métadonnées pour une session de synchronisation.

Exceptions

Exception	Condition
ArgumentNullException	tableName ou dataSet est une null Nothing nullptr unit une référence Null (Nothing dans Visual Basic) .
DataSyncException	Une autre transaction est en cours.

Notes

Cette méthode suppose que la table se trouve dans la base de données client ; sinon, la méthode lève une exception. Si la table existe mais que le suivi n'est pas activé, un suivi bidirectionnel est activé. Les lignes sont marquées à l'aide d'une valeur DataRowState afin de faire la différence entre les insertions, les mises à jour et les suppressions.

Les modifications sont appliquées selon l'ordre suivant : suppressions, insertions, puis mises à jour. L'ordre dans lequel les modifications sont appliquées à chaque table dans un groupe de synchronisation dépend de l'ordre dans lequel les tables sont ajoutées au groupe. Les suppressions sont appliquées dans l'ordre inverse de celui dans lequel les tables sont ajoutées. Les insertions et les mises à jour sont appliquées dans l'ordre dans lequel les tables sont ajoutées.

Par exemple, si vous ajoutez la table SalesOrderHeader, puis SalesOrderDetail au même groupe de synchronisation, l'ordre de traitement suivant est utilisé pendant la synchronisation :