Método AddSubscription (Replication)
Os aplicativos chamam o método AddSubscription para criar uma nova assinatura anônima para uma publicação existente do Microsoft SQL Server. Depois de chamar o método AddSubscription, o aplicativo deve chamar o método Synchronize para sincronizar a nova assinatura para a publicação.
Sintaxe
object.AddSubscription(DBADDOPTION)
Aplica-se a
Objeto Replication do SQL Server Compact 3.5 (SQL Server Compact 3.5)
Parâmetros genéricos
| Parâmetro | Descrição |
|---|---|
DBADDOPTION |
Especifica como criar a nova assinatura |
Parâmetro DBADDOPTION
DBADDOPTION especifica como criar a nova assinatura. Esse parâmetro determina se um novo banco de dados do SQL Server Compact 3.5 é criado ou se é usado um banco de dados existente, de acordo com as configurações da seguinte tabela:
| Constante | Valor | Descrição |
|---|---|---|
EXISTING_DATABASE |
0 |
Presume que o banco de dados do SQL Server Compact 3.5 já esteja criado. |
CREATE_DATABASE |
1 |
Faz com que o banco de dados do SQL Server Compact 3.5 seja criado no dispositivo (padrão). |
O valor de DBADDOPTION EXISTING_DATABASE especifica que o banco de dados já existe, mas o conteúdo precisa ser obtido do Publicador. Neste caso, os métodos AddSubscription e Synchronize criam a assinatura do SQL Server Compact 3.5 e baixam o conteúdo do banco de dados do Publicador do SQL Server.
Como um único banco de dados do SQL Server Compact 3.5 pode ser um assinante de várias publicações, é necessário ter uma atenção especial ao usar o valor EXISTING_DATABASE. Se o banco de dados já existe, e você está inserindo uma assinatura adicional, é necessário especificar as propriedades Publisher, Publication e PublisherDatabase antes de chamar o método AddSubscription.
O valor de DBADDOPTION CREATE_DATABASE especifica que o banco de dados do SQL Server Compact 3.5 deve primeiro ser criado e, em seguida, o conteúdo da assinatura é obtido do Publicador. Neste caso, os métodos AddSubscription e Synchronize criam a assinatura e o banco de dados do SQL Server Compact 3.5 e baixam o conteúdo do banco de dados do Publicador do SQL Server.
Protótipo
HRESULT AddSubscription(DBADDOPTION DBAddOption);
Retorna
| Código de retorno | Descrição |
|---|---|
S_OK |
O método obteve êxito. |
Any FAILED(HRESULT) |
Verifique a coleção SSCEErrors para obter informações detalhadas sobre erros. |
Comentários
Para que um aplicativo do SQL Server Compact 3.5 possa assinar uma publicação e replicar dados, um administrador de banco de dados deve primeiro configurar o SQL Server para dar suporte à replicação de mesclagem e criar uma publicação do SQL Server que seja habilitada para assinaturas do SQL Server Compact 3.5.
Consulte também
Referência
Propriedade Publisher (Replication)
Propriedade Publication (Replication)
Propriedade PublisherDatabase (Replication)