Comment : initialiser la synchronisation entre des bases de données locales et distantes

Article
08/21/2008

Mise à jour : novembre 2007

Après avoir ajouté un cache de base de données locale et fourni des informations de configuration dans la boîte de dialogue Configurer la synchronisation des données, vous devez ajouter le code dans votre application pour synchroniser réellement les bases de données locales et distantes. Initialisez la synchronisation en appelant la méthode Synchronize d'un SyncAgent.

Il est important de comprendre cette synchronisation synchronise uniquement les données entre les données distantes et la base de données locale (.sdf). Les données dans votre application doivent être rechargées à partir de la base de données. N'oubliez pas de recharger votre source de données d'application avec les données mises à jour de la base de données locale. Par exemple, appelez la méthode TableAdapter.Fill pour charger la table de données du groupe de données avec les données mises à jour à partir de la base de données locale.

La boîte de dialogue Configurer la synchronisation des données inclut un lien Afficher l'exemple de code qui fournit un exemple de code avec la syntaxe correcte pour appeler la méthode Synchronize. Incluez cet exemple de code dans n'importe quel endroit de l'application où la synchronisation doit être exécutée.

Remarque :
Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'interface utilisateur Visual Studio dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d'informations, consultez Paramètres Visual Studio.

Procédure

Pour initialiser la synchronisation entre des bases de données locales et distantes

Double-cliquez sur le fichier .sync dans l'Explorateur de solutions pour ouvrir la boîte de dialogue Configurer la synchronisation des données.
Cliquez sur le lien Afficher l'exemple de code dans la boîte de dialogue Configurer la synchronisation des données.
Cliquez sur Copier le code dans le Presse-papiers puis cliquez sur Fermer.

Collez l'exemple de code que vous avez copié dans l'étape précédente dans votre application. Collez-le où vous souhaitez initialiser l'appel de synchronisation. Le code suivant indique comment initialiser la synchronisation pour une application configurée pour synchroniser la table Customers de Northwind :

' Call SyncAgent.Synchronize to initiate the synchronization process.
' Synchronization updates only the local database,
' not your project's data source.
Dim syncAgent As NorthwindCacheSyncAgent = New NorthwindCacheSyncAgent()
Dim syncStats As Microsoft.Synchronization.Data.SyncStatistics = syncAgent.Synchronize()

' TODO: Reload your project data source from the local database.
' (For example, call the TableAdapter.Fill method.)

// Call SyncAgent.Synchronize() to initiate the synchronization process.
// Synchronization updates only the local database, not your project's data source.
NorthwindCacheSyncAgent syncAgent = new NorthwindCacheSyncAgent();
Microsoft.Synchronization.Data.SyncStatistics syncStats = syncAgent.Synchronize();

// TODO: Reload your project data source from the local database. (For example, call the TableAdapter.Fill method.)

Après la synchronisation, ajoutez le code pour remplir de nouveau la source de données dans votre application avec les données dans la base de données locale synchronisée.

Voir aussi

Tâches

Procédure pas à pas : création d'une application occasionnellement connectée

Comment : configurer la synchronisation de données dans une application

Concepts

Vue d'ensemble des applications occasionnellement connectées

SQL Server Compact 3.5 et Visual Studio

Partager via