Metodo AddSubscription (replica)
Il metodo AddSubscription viene chiamato dalle applicazioni per creare una nuova sottoscrizione anonima per una pubblicazione esistente di Microsoft SQL Server. Dopo la chiamata del metodo AddSubscription, l'applicazione deve chiamare il metodo Synchronize per sincronizzare la nuova sottoscrizione della pubblicazione.
Sintassi
object.AddSubscription(DBADDOPTION)
Si applica a
Oggetto Replication di SQL Server Compact 3.5 (SQL Server Compact 3.5)
Parametri generici
| Parametro | Descrizione |
|---|---|
DBADDOPTION |
Specifica come deve essere creata la nuova sottoscrizione |
Parametro DBADDOPTION
DBADDOPTION specifica come deve essere creata la nuova sottoscrizione. Questo parametro determina se verrà creato un nuovo database di SQL Server Compact 3.5 oppure verrà utilizzato un database esistente, in base alle impostazioni descritte nella tabella seguente.
| Costante | Valore | Descrizione |
|---|---|---|
EXISTING_DATABASE |
0 |
Presuppone che il database di SQL Server Compact 3.5 sia già stato creato. |
CREATE_DATABASE |
1 |
Determina la creazione del database di SQL Server Compact 3.5 sul dispositivo (impostazione predefinita). |
Il valore EXISTING_DATABASE di DBADDOPTION specifica che il database esiste già, ma è necessario ottenerne il contenuto dal server di pubblicazione. In questo caso, le chiamate dei metodi AddSubscription e Synchronize determinano la creazione della sottoscrizione di SQL Server Compact 3.5 e il successivo download del contenuto del database dal server di pubblicazione di SQL Server.
Poiché un singolo database di SQL Server Compact 3.5 può essere un Sottoscrittore di più pubblicazioni, è necessario prestare particolare attenzione nell'utilizzo del valore EXISTING_DATABASE. Se il database esiste già e si aggiunge un'ulteriore sottoscrizione, si devono specificare le proprietà Publisher, Publication e PublisherDatabase prima di chiamare il metodo AddSubscription.
Il valore CREATE_DATABASE di DBADDOPTION specifica che è innanzitutto necessario creare il database di SQL Server Compact 3.5 e quindi ottenere il contenuto della sottoscrizione dal server di pubblicazione. In questo caso, le chiamate dei metodi AddSubscription e Synchronize determinano la creazione del database di SQL Server Compact 3.5 e la sottoscrizione e il download del contenuto del database dal server di pubblicazione di SQL Server.
Prototipo
HRESULT AddSubscription(DBADDOPTION DBAddOption);
Valori restituiti
| Codice restituito | Descrizione |
|---|---|
S_OK |
Il metodo ha avuto esito positivo. |
Qualsiasi FAILED(HRESULT) |
Vedere l'insieme SSCEErrors per informazioni dettagliate sull'errore. |
Osservazioni
Prima che un'applicazione SQL Server Compact 3.5 possa eseguire la sottoscrizione di una pubblicazione e la replica dei dati, è innanzitutto necessario che un amministratore di database configuri SQL Server per il supporto della replica di tipo merge e crei una pubblicazione di SQL Server abilitata per le sottoscrizioni di SQL Server Compact 3.5.
Vedere anche
Riferimento
Proprietà Publisher (replica)
Proprietà Publication (replica)
Proprietà PublisherDatabase (replica)
Altre risorse
Metodi dell'oggetto Replication