Método SaveProperties

Artigo
01/17/2011

Recupera todos os valores armazenados nas propriedades da classe SqlCeReplication para a assinatura atual e as armazena em uma tabela do sistema.

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

Sintaxe

'Declaração
Public Sub SaveProperties
'Uso
Dim instance As SqlCeReplication

instance.SaveProperties()

public void SaveProperties()

public:
void SaveProperties()

member SaveProperties : unit -> unit

public function SaveProperties()

Comentários

É necessário criar uma assinatura com êxito antes de salvar as propriedades de sincronização; todos os parâmetros necessários para executar a sincronização devem ser fornecidos para que uma chamada de SaveProperties tenha êxito. Se parâmetros não necessários forem omitidos ao salvar as propriedades de sincronização, eles serão definidos com seus valores padrão, mesmo que já existam propriedades de sincronização salvas. Para evitar que as propriedades sejam substituídas, o usuário deve primeiro recuperar as propriedades de sincronização chamando LoadProperties, alterar as propriedades particulares e, em seguida, salvar as propriedades de sincronização novamente.

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.

Exemplos

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

Dim repl As SqlCeReplication = Nothing

Try
    ' Create SqlCeReplication instance
    '
    '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/sqlmobile/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"

    ' Store all the properties in the database
    '
    repl.SaveProperties()

    ' In the future all you need to do is load the properties
    '
    '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.SubscriberConnectionString = "Data Source='Test.sdf'; Pwd='<enterStrongPassword>'"
    repl.LoadProperties()

    ' Now the SqlCeReplication instance is ready to sync
    '
    repl.Synchronize()

Catch
    ' Handle errors here
Finally
    ' Dispose the repl object
    '
    repl.Dispose()
End Try

SqlCeReplication repl = null;

try
{
    // Create SqlCeReplication instance
    //
    //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/sqlmobile/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";

    // Store all the properties in the database
    //
    repl.SaveProperties();

    // In the future all you need to do is load the properties
    //
    //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.SubscriberConnectionString = "Data Source='Test.sdf'; Pwd='<enterStrongPassword>'";
    repl.LoadProperties();

    // Now the SqlCeReplication instance is ready to sync
    //
    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

Partilhar via