Partager via


Méthode AddSubscription (Réplication)

Les applications appellent la méthode AddSubscription pour créer un abonnement anonyme à une publication MicrosoftSQL Server. Après avoir appelé la méthode AddSubscription, l'application doit appeler la méthode Synchronize pour synchroniser le nouvel abonnement à la publication.

Syntaxe

object.AddSubscription(DBADDOPTION)

Application

Objet SQL Server Compact 3.5 Replication

Paramètres génériques

Paramètre

Description

DBADDOPTION

Indique comment créer le nouvel abonnement

Paramètre DBADDOPTION

Le paramètre DBADDOPTIONindique comment créer le nouvel abonnement. Ce paramètre détermine si une nouvelle base de données SQL Server Compact 3.5 est créée ou si une base de données existante est utilisée, en fonction des valeurs du tableau suivant :

Constante

Valeur

Description

EXISTING_DATABASE

0

Suppose que la base de données SQL Server Compact 3.5 est déjà créée.

CREATE_DATABASE

1

Crée la base de données SQL Server Compact 3.5 sur l'appareil (valeur par défaut).

La valeur DBADDOPTIONEXISTING_DATABASE spécifie que la base de données existe déjà, mais le contenu doit être obtenu auprès du serveur de publication. Dans ce cas, les méthodes AddSubscription et Synchronize créent l'abonnement SQL Server Compact 3.5, puis téléchargent le contenu de la base de données depuis le serveur de publication SQL Server.

Une même base de données SQL Server Compact 3.5 pouvant être un Abonné à plusieurs publications, vous devez prêter une attention particulière lorsque vous utilisez la valeur EXISTING_DATABASE. Si la base de données existe déjà et que vous ajoutez un abonnement, vous devez spécifier les propriétés Publisher, Publication et PublisherDatabase avant d'appeler la méthode AddSubscription.

La valeur DBADDOPTIONCREATE_DATABASE spécifie que la base de données SQL Server Compact 3.5 doit être créée avant d'obtenir le contenu de l'abonnement à partir du serveur de publication. Dans ce cas, les méthodes AddSubscription et Synchronize créent la base de données et l'abonnement SQL Server Compact 3.5, puis téléchargent le contenu de la base de données depuis le serveur de publication SQL Server.

Prototype

HRESULT AddSubscription(DBADDOPTION DBAddOption);

Valeurs renvoyées

Code de retour

Description

S_OK

La méthode a réussi.

Tout HRESULT signalant un échec (FAILED)

Pour obtenir des informations détaillées sur les erreurs, consultez la collection SSCEErrors.

Notes

Pour qu'une application SQL Server Compact 3.5 puisse s'abonner à une publication et répliquer des données, un administrateur de bases de données doit d'abord configurer SQL Server de manière à prendre en charge la réplication de fusion et créer une publication SQL Server activée pour les abonnements SQL Server Compact 3.5.

Voir aussi

Autres ressources

Méthodes de l'objet Replication

Propriété Publisher (Réplication)

Propriété Publication (Réplication)

Propriété PublisherDatabase (Réplication)