次の方法で共有

SqlCeReplication.LoadProperties Method

  • [アーティクル]

同期プロパティに保存されたすべての値を取得し、その保存値を 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 関数を正常に実行するには、SubscriberConnectionString 内に指定されたデータベースにあるサブスクリプションが 1 つだけの場合を除き、すべての SqlCeReplication オブジェクト プロパティを指定する必要があります。データベースを 1 つのパブリケーションだけにサブスクライブする場合、次のプロパティを省略できます。

データベース内に複数のサブスクリプションが存在する場合に、これらのプロパティを設定せずに LoadProperties を呼び出すと、データベース内の各サブスクリプションに対してエラーが発生します。コレクション内の各エラーには、データベース内の各サブスクリプションに対する Publisher、Publication、および PublisherDatabase の各プロパティが含まれます。

SaveProperties を呼び出すと、パスワード プロパティの値がデータベースに格納されます。これらの値は、一意のデバイス ハードウェア キーを使用して、自動的に暗号化されます。そのため、1 つのデバイス (またはサーバー) についてサブスクリプション プロファイルを作成し、そのデータベースを新しいデバイスにコピーすると、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
}

スレッド セーフ

この型の public static (Visual Basic では Shared ) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

開発プラットフォーム

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