SqlCeReplication.AddSubscription Method

Artigo
01/14/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 _
)

public void AddSubscription (
    AddOption addOption
)

public:
void AddSubscription (
    AddOption addOption
)

public void AddSubscription (
    AddOption addOption
)

public function AddSubscription (
    addOption : AddOption
)

Parâmetros

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 publicador 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 Publicador do SQL Server.
ExistingDatabase	Especifica se o banco de dados já existe, mas o conteúdo é obtido do publicador 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 Publicador 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.

Exemplo

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();
}

Segurança de thread

Quaisquer membros estáticos públicos (compartilhados no Microsoft Visual Basic) desse tipo são thread safe. Não há garantia de que qualquer membro de instância seja thread safe.

Plataformas

Plataformas de desenvolvimento

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Informações de versão
.NET Framework e NET Compact Framework
Com suporte no 3.5
.NET Framework
Com suporte no 3.0
.NET Compact Framework e .Net Framework
Com suporte no 2.0

Consulte também

Referência

SqlCeReplication Class
SqlCeReplication Members
System.Data.SqlServerCe Namespace

Compartilhar via