AddSubscription-Methode (Replikation)
Anwendungen rufen die AddSubscription-Methode auf, um ein neues anonymes Abonnement für eine vorhandene Microsoft SQL Server-Publikation zu erstellen. Nach dem Aufrufen der AddSubscription-Methode muss die Anwendung die Synchronize-Methode aufrufen, um das neue Abonnement mit der Publikation zu synchronisieren.
Syntax
object.AddSubscription(DBADDOPTION)
Betrifft
SQL Server 2005 Compact Edition (SQL Server Compact Edition) Replication-Objekt
Generische Parameter
Parameter | Beschreibung |
---|---|
DBADDOPTION |
Gibt an, wie das neue Abonnement erstellt werden soll. |
DBADDOPTION-Parameter
Der DBADDOPTION-Parameter gibt an, wie das neue Abonnement erstellt werden soll. Dieser Parameter bestimmt anhand der Einstellungen in der folgenden Tabelle, ob eine neue SQL Server Compact Edition-Datenbank erstellt oder eine vorhandene Datenbank verwendet wird:
Konstante | Wert | Beschreibung |
---|---|---|
EXISTING_DATABASE |
0 |
Geht davon aus, dass die SQL Server Compact Edition-Datenbank bereits erstellt wurde. |
CREATE_DATABASE |
1 |
Die SQL Server Compact Edition-Datenbank wird auf dem Gerät erstellt (Standard). |
Der DBADDOPTION-Wert EXISTING_DATABASE gibt an, dass die Datenbank bereits vorhanden ist, aber die Inhalte vom Verleger abgerufen werden müssen. In diesem Fall bewirken die Methoden AddSubscription und Synchronize, dass das SQL Server Compact Edition-Abonnement erstellt und anschließend die Datenbankinhalte vom SQL Server-Verleger gedownloadet werden.
Eine einzige SQL Server Compact Edition-Datenbank kann ein Abonnement für mehrere Publikationen sein. Daher müssen Sie bei der Verwendung des EXISTING_DATABASE-Werts dieser Tatsache besondere Aufmerksamkeit widmen. Falls die Datenbank bereits vorhanden ist und Sie ein zusätzliches Abonnement hinzufügen, müssen Sie die Eigenschaften Publisher, Publication und PublisherDatabase angeben, bevor Sie die AddSubscription-Methode aufrufen.
Der DBADDOPTION-Wert CREATE_DATABASE gibt an, dass zuerst die SQL Server Compact Edition-Datenbank erstellt werden muss, bevor die Abonnementinhalte vom Verleger abgerufen werden. In diesem Fall bewirken die Methoden AddSubscription und Synchronize, dass die SQL Server Compact Edition-Datenbank und das Abonnement erstellt und anschließend die Datenbankinhalte vom SQL Server-Verleger gedownloadet werden.
Prototyp
HRESULT AddSubscription(DBADDOPTION DBAddOption);
Rückgabewerte
Rückgabecode | Beschreibung |
---|---|
S_OK |
Die Methode wurde erfolgreich abgeschlossen. |
Beliebiger FAILED(HRESULT)-Wert |
Ausführliche Fehlerinformationen finden Sie in der SSCEErrors-Auflistung. |
Hinweise
Bevor eine SQL Server Compact Edition-Anwendung eine Publikation abonnieren und Daten replizieren kann, muss der Datenbankadministrator für SQL Server zuerst die Unterstützung der Mergereplikation konfigurieren und eine SQL Server-Publikation erstellen, für die SQL Server Compact Edition-Abonnements aktiviert sind.
Siehe auch
Referenz
Publisher-Eigenschaft (Replikation)
Publication-Eigenschaft (Replikation)
PublisherDatabase-Eigenschaft (Replikation)