Método AddSubscription

Artigo
01/17/2011

Cria uma nova assinatura anônima de uma publicação do SQL Server existente. Depois de chamar o método AddSubscription, o aplicativo deve chamar o método Synchronize para sincronizar a nova assinatura da publicação baseado no instantâneo mais recente.

Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (em System.Data.SqlServerCe.dll)

Sintaxe

'Declaração
Public Sub AddSubscription ( _
    addOption As AddOption _
)
'Uso
Dim instance As SqlCeReplication
Dim addOption As AddOption

instance.AddSubscription(addOption)

public void AddSubscription(
    AddOption addOption
)

public:
void AddSubscription(
    AddOption addOption
)

member AddSubscription : 
        addOption:AddOption -> unit

public function AddSubscription(
    addOption : AddOption
)

Parâmetros

addOption
Tipo: System.Data.SqlServerCe. . :: . .AddOption

Comentários

A replicação do SQL Server Compact 3.5 dá suporte somente a assinaturas anônimas.

O administrador do banco de dados deve configurar o SQL Server para dar suporte à replicação, criar a publicação do SQL Server e habilitar a publicação para assinaturas anônimas, de forma que qualquer aplicativo do SQL Server Compact 3.5 possa inscrever-se na publicação. O administrador faz isso no sistema do SQL Server, usando as interfaces administrativa ou de programação da replicação do SQL Server.

O valor de AddOption especifica a origem do banco de dados de assinaturas do SQL Server Compact 3.5 recém-criado. O valor pode ser uma das seguintes constantes:

Valor	Descrição
CreateDatabase	Especifica se o banco de dados do SQL Server Compact 3.5 deve ser criado primeiro e se o conteúdo da assinatura é obtido em seguida do editor pela rede. Nesse caso, as chamadas do método AddSubscription e Synchronize criam o banco de dados do SQL Server Compact 3.5 e baixam seu conteúdo do Editor do SQL Server.
ExistingDatabase	Especifica se o banco de dados já existe, mas o conteúdo é obtido do editor pela rede. Nesse caso, as chamadas do método AddSubscription e Synchronize criam a assinatura do SQL Server Compact 3.5 e baixam o conteúdo do banco de dados do Editor do SQL Server.

AddOption afeta somente como o banco de dados do SQL Server Compact 3.5 é criado inicialmente e tratado pelo Agente de Cliente do SQL Server Compact 3.5, determinando assim quais dados são baixados do servidor para o dispositivo com o Windows Mobile.

Exemplos

Este exemplo cria um novo banco de dados de assinaturas passando o valor CreateDatabase de AddOption ao chamar o método AddSubscription.

Dim repl As SqlCeReplication = Nothing

Try
    ' Instantiate and configure SqlCeReplication object
    '
    'NOTE: when possible, prompt users to enter security 
    'credentials at runtime. If you store credentials in a file, 
    'you must secure the file to prevent unauthorized access.
    '
    repl = New SqlCeReplication()
    repl.InternetUrl = "https://www.adventure-works.com/sqlce/sqlcesa35.dll"
    repl.InternetLogin = "MyInternetLogin"
    repl.InternetPassword = "<enterStrongPassword>"
    repl.Publisher = "MyPublisher"
    repl.PublisherDatabase = "MyPublisherDatabase"
    repl.PublisherLogin = "MyPublisherLogin"
    repl.PublisherPassword = "<enterStrongPassword>"
    repl.Publication = "MyPublication"
    repl.Subscriber = "MySubscriber"
    repl.SubscriberConnectionString = "Data Source=MyDatabase.sdf"

    ' Create the local SQL Mobile Database subscription
    '
    repl.AddSubscription(AddOption.CreateDatabase)

    ' Synchronize to the SQL Server to populate the Subscription 
    '
    repl.Synchronize()
Catch
    ' Handle errors here
    '
Finally
    ' Dispose the repl object
    '
    repl.Dispose()
End Try

SqlCeReplication repl = null;

try
{
    // Instantiate and configure SqlCeReplication object
    //
    //NOTE: when possible, prompt users to enter security 
    //credentials at runtime. If you store credentials in a file, 
    //you must secure the file to prevent unauthorized access.
    //
    repl = new SqlCeReplication();
    repl.InternetUrl = "https://www.adventure-works.com/sqlce/sqlcesa35.dll";
    repl.InternetLogin = "MyInternetLogin";
    repl.InternetPassword = "<enterStrongPassword>";
    repl.Publisher = "MyPublisher";
    repl.PublisherDatabase = "MyPublisherDatabase";
    repl.PublisherLogin = "MyPublisherLogin";
    repl.PublisherPassword = "<enterStrongPassword>";
    repl.Publication = "MyPublication";
    repl.Subscriber = "MySubscriber";
    repl.SubscriberConnectionString = "Data Source=MyDatabase.sdf";

    // Create a local SQL Mobile Database subscription
    //
    repl.AddSubscription(AddOption.CreateDatabase);

    // Synchronize to the SQL Server database
    //
    repl.Synchronize();
}
catch (SqlCeException)
{
    // Handle errors here
    //
}
finally
{
    // Dispose the repl object
    //
    repl.Dispose();
}

Consulte também

Referência

SqlCeReplication Classe

Membros SqlCeReplication

Namespace System.Data.SqlServerCe

Compartilhar via