SqlCeReplication.LoadProperties Method

Articolo
01/14/2011

Consente di recuperare tutti i valori memorizzati delle proprietà di sincronizzazione, quindi compila le proprietà della classe SqlCeReplication con i valori salvati.

Spazio dei nomi: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in system.data.sqlserverce.dll)

Sintassi

'Dichiarazione
Public Function LoadProperties As Boolean

public bool LoadProperties ()

public:
bool LoadProperties ()

public boolean LoadProperties ()

public function LoadProperties () : boolean

Osservazioni

Affinché la funzione LoadProperties abbia esito positivo, è necessario fornire tutte le proprietà dell'oggetto SqlCeReplication, a meno che vi sia una sola sottoscrizione per il database specificato nella proprietà SubscriberConnectionString. Se nel database vi è una sottoscrizione a una sola pubblicazione, è possibile omettere le seguenti proprietà:

Se il metodo LoadProperties viene chiamato senza che siano state impostate queste proprietà e nel database esiste una sola sottoscrizione, verrà generato un errore per ogni sottoscrizione del database. Ogni errore dell'insieme contiene i parametri di stringa delle proprietà Publisher, Publication e PublisherDatabase per ogni sottoscrizione nel database.

Quando viene chiamato il metodo SaveProperties, i valori delle proprietà della password vengono memorizzati nel database. Questi valori vengono crittografati automaticamente con la chiave hardware univoca di dispositivo. Se pertanto si crea un profilo di sottoscrizione su un dispositivo, o server, e quindi si copia il database su un nuovo dispositivo, LoadProperties non riuscirà a recuperare la password dal profilo. È possibile fornire la password corretta manualmente e quindi chiamare di nuovo il metodo SaveProperties per mantenere il profilo sul nuovo dispositivo.

Esempio

Nell'esempio riportato di seguito viene illustrato come utilizzare il metodo 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
}

Affidabilità

Tutti i membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono affidabili. Non è invece garantita l'affidabilità dei membri dell'istanza.

Piattaforme

Piattaforme di sviluppo

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
Informazioni sulla versione
.NET Framework e .NET Compact Framework
Supportato in 3.5
.NET Framework
Supportato in 3.0
.NET Compact Framework e .NET Framework
Supportato in 2.0

Vedere anche

Riferimento

SqlCeReplication Class
SqlCeReplication Members
System.Data.SqlServerCe Namespace

Condividi tramite