SqlCeClientSyncProvider.ApplyChanges méthode (String, DataSet, SyncAnchor)

Article
10/17/2009

Applique les insertions, mises à jour et suppressions pour un groupe de synchronisation à la base de données client en fonction d'un nom de table, 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
<SuppressMessageAttribute("Microsoft.Naming", "CA1702:CompoundWordsShouldBeCasedCorrectly")> _
Public Function ApplyChanges ( _
    tableName As String, _
    dataSet As DataSet, _
    serverAnchor As SyncAnchor _
) As SyncContext
'Utilisation
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)

[SuppressMessageAttribute("Microsoft.Naming", "CA1702:CompoundWordsShouldBeCasedCorrectly")] 
public SyncContext ApplyChanges (
    string tableName,
    DataSet dataSet,
    SyncAnchor serverAnchor
)

[SuppressMessageAttribute(L"Microsoft.Naming", L"CA1702:CompoundWordsShouldBeCasedCorrectly")] 
public:
SyncContext^ ApplyChanges (
    String^ tableName, 
    DataSet^ dataSet, 
    SyncAnchor^ serverAnchor
)

/** @attribute SuppressMessageAttribute("Microsoft.Naming", "CA1702:CompoundWordsShouldBeCasedCorrectly") */ 
public SyncContext ApplyChanges (
    String tableName, 
    DataSet dataSet, 
    SyncAnchor serverAnchor
)

SuppressMessageAttribute("Microsoft.Naming", "CA1702:CompoundWordsShouldBeCasedCorrectly") 
public function ApplyChanges (
    tableName : String, 
    dataSet : DataSet, 
    serverAnchor : SyncAnchor
) : SyncContext

Paramètres

tableName
Table dans la base de données client pour laquelle appliquer les modifications.

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

serverAnchor
Objet SyncAnchor qui représente la valeur NewAnchor pour cette session de synchronisation.

Valeur de retour

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

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 la table SalesOrderDetail au même groupe de synchronisation, l'ordre de traitement suivant est utilisé pendant la synchronisation :

Les suppressions sont appliquées à SalesOrderDetail, puis à SalesOrderHeader.
Les insertions sont appliquées à SalesOrderHeader, puis à SalesOrderDetail.
Les mises à jour sont appliquées à SalesOrderHeader, puis à SalesOrderDetail.

Voir aussi

Référence

Classe SqlCeClientSyncProvider
Membres SqlCeClientSyncProvider
Espace de noms Microsoft.Synchronization.Data.SqlServerCe

Partager via