SqlCeReplication.LoadProperties Method

Artigo
01/14/2011

Recupera todos os valores armazenados para as propriedades de sincronização e preenche as propriedades da classe SqlCeReplication com esses valores salvos.

Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (em system.data.sqlserverce.dll)

Sintaxe

'Declaração
Public Function LoadProperties As Boolean

public bool LoadProperties ()

public:
bool LoadProperties ()

public boolean LoadProperties ()

public function LoadProperties () : boolean

Comentários

Para que a função LoadProperties tenha êxito, forneça todas as propriedades do objeto SqlCeReplication, a menos que o banco de dados especificado na SubscriberConnectionString possua apenas uma assinatura. Se o banco de dados assinar apenas uma publicação, você poderá omitir as seguintes propriedades:

Se LoadProperties for chamado sem configurar essas propriedades e existir mais de uma assinatura no banco de dados, será gerado um erro para cada assinatura no banco de dados. Cada erro na coleção contém os parâmetros da cadeia de caracteres das propriedades Publisher, Publication e PublisherDatabase de cada assinatura no banco de dados.

Quando SaveProperties é chamado, os valores das propriedades de senha são armazenados no banco de dados. Esses valores são criptografados automaticamente com a chave de hardware exclusiva do dispositivo. Assim, se você criar um perfil de assinatura em um dispositivo (ou um servidor) e, em seguida, copiar o banco de dados para um novo dispositivo, o LoadProperties falhará ao recuperar a senha do perfil. Você pode fornecer a senha correta manualmente e, em seguida, chamar SaveProperties novamente que o perfil persista no novo dispositivo.

Exemplo

O exemplo a seguir mostra como usar o método LoadProperties.

Try
    '
    '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.
    '
    Dim repl As New SqlCeReplication()
    repl.SubscriberConnectionString = "Data Source='Test.sdf'; Pwd='<enterStrongPassword>'"
    repl.LoadProperties()

    repl.Synchronize()
Catch
    ' Handle errors here
End Try

try
{
    //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.
    //
    SqlCeReplication repl = new SqlCeReplication();
    repl.SubscriberConnectionString = "Data Source='Test.sdf'; Pwd='<enterStrongPassword>'";
    repl.LoadProperties();

    repl.Synchronize();
}
catch (SqlCeException)
{
    // Handle errors here
}

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

Partilhar via