SqlCeReplication.LoadProperties Method

Получает все значения свойств синхронизации и заполняет ими свойства класса SqlCeReplication. Получает все значения свойств синхронизации и заполняет ими свойства класса SqlCeReplication.

Пространство имен: System.Data.SqlServerCe
Сборка: System.Data.SqlServerCe (в system.data.sqlserverce.dll)

Синтаксис

'Декларация
Public Function LoadProperties As Boolean

public bool LoadProperties ()

public:
bool LoadProperties ()

public boolean LoadProperties ()

public function LoadProperties () : boolean

Замечания

Чтобы функция LoadProperties была выполнена успешно, необходимо задать все свойства объекта SqlCeReplication, за исключением случая, когда база данных, заданная в свойстве SubscriberConnectionString, имеет всего одну подписку. Если база данных подписана только на одну публикацию, то могут быть пропущены следующие свойства.

• Publisher

• Publication

• PublisherDatabase

Если при вызове функции LoadProperties эти свойства не установлены, а в базе данных существует более одной подписки, то для каждой подписки в базе данных возникнет ошибка. Ошибки в коллекции будут для каждой из подписок в базе данных содержать символьные значения свойств Publisher, Publication и PublisherDatabase.

При вызове SaveProperties значения свойств, содержащих пароли, сохраняются в базе данных. Они будут автоматически зашифрованы при использовании уникального аппаратного ключа устройства. Таким образом, при создании профиля подписки на одном устройстве (или на сервере) и последующем копировании базы данных на новое устройство LoadProperties не сможет получить пароль из профиля. Чтобы сохранить профиль на новом устройстве, пароль можно указать вручную и затем снова вызвать метод SaveProperties.

Замечания

Чтобы функция LoadProperties была выполнена успешно, необходимо задать все свойства объекта SqlCeReplication, за исключением случая, когда база данных, заданная в свойстве SubscriberConnectionString, имеет всего одну подписку. Если база данных подписана только на одну публикацию, то могут быть пропущены следующие свойства.

• Publisher

• Publication

• PublisherDatabase

Если при вызове функции LoadProperties эти свойства не установлены, а в базе данных существует более одной подписки, то для каждой подписки в базе данных возникнет ошибка. Ошибки в коллекции будут для каждой из подписок в базе данных содержать символьные значения свойств Publisher, Publication и PublisherDatabase.

При вызове SaveProperties значения свойств, содержащих пароли, сохраняются в базе данных. Они будут автоматически зашифрованы при использовании уникального аппаратного ключа устройства. Таким образом, при создании профиля подписки на одном устройстве (или на сервере) и последующем копировании базы данных на новое устройство LoadProperties не сможет получить пароль из профиля. Чтобы сохранить профиль на новом устройстве, пароль можно указать вручную и затем снова вызвать метод SaveProperties.

Пример

Следующий пример демонстрирует использование метода 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
}

Пример

Следующий пример демонстрирует использование метода 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
}

Многопоточное использование

Все общие статические члены (Shared в Microsoft Visual Basic) этого типа можно использовать в многопоточных операциях. Безопасная многопоточная работа с членами экземпляров типа не гарантируется.

Платформы

Платформы разработки

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
Сведения о версии
.NET Framework и NET Compact Framework
Поддерживается в версии 3.5
.NET Framework
Поддерживается в версии 3.0
.NET Compact Framework и .Net Framework
Поддерживается в версии 2.0

См. также

Справочник

SqlCeReplication Class
SqlCeReplication Members
System.Data.SqlServerCe Namespace