Partager via


Méthode AddSubscription (Réplication)

Les applications appellent la méthode AddSubscription pour créer un abonnement anonyme à une publication Microsoft SQL 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 Replication de SQL Server 2005 Compact Edition (SQL Server Compact Edition)

Paramètres génériques

Paramètre Description

DBADDOPTION

Indique comment créer le nouvel abonnement

Paramètre DBADDOPTION

Le paramètre DBADDOPTION indique comment créer le nouvel abonnement. Ce paramètre détermine si une nouvelle base de données SQL Server Compact Edition 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 Edition est déjà créée.

CREATE_DATABASE

1

Crée la base de données SQL Server Compact Edition 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 Edition, 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 Edition 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 Edition 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 Edition, 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 Edition 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 Edition.

Voir aussi

Référence

Propriété Publisher (Réplication)
Propriété Publication (Réplication)
Propriété PublisherDatabase (Réplication)

Autres ressources

Méthodes de l'objet Replication

Aide et information

Assistance sur SQL Server Compact Edition