SqlCeReplication.LoadProperties メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

SqlCeReplication.LoadProperties メソッド

同期プロパティに保存されたすべての値を取得し、その保存値を Replication クラスプロパティに入力します。

名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)
構文

Visual Basic (宣言)

Public Function LoadProperties As
 Boolean

Visual Basic (使用法)

Dim instance As SqlCeReplication
Dim returnValue As Boolean

returnValue = instance.LoadProperties

public bool LoadProperties ()

C++

public:
bool LoadProperties ()

public boolean LoadProperties ()

JScript

public function LoadProperties () : boolean

解説

LoadProperties 関数を正常に実行するには、SubscriberConnectionString 内に指定されたデータベースにあるサブスクリプションが 1 つだけの場合を除き、すべての Replication オブジェクトプロパティを指定する必要があります。データベースを 1 つのパブリケーションだけにサブスクライブする場合、次のプロパティを省略できます。

Publisher
Publication
PublisherDatabase

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

SaveProperties を呼び出すと、パスワードプロパティの値がデータベースに格納されます。これらの値は、一意のデバイスハードウェアキーを使用して、自動的に暗号化されます。そのため、1 つのデバイス (またはサーバー) についてサブスクリプションプロファイルを作成し、そのデータベースを新しいデバイスにコピーすると、LoadProperties がプロファイルからのパラメータ取得に失敗します。正しいパスワードを手動で指定し、SaveProperties を再度呼び出すと、新しいデバイスのプロファイルを保持できます。

使用例

LoadProperties メソッドを使用する方法の例を次に示します。

Visual Basic

Try
    Dim repl As New SqlCeReplication()
    repl.SubscriberConnectionString = "Data Source='Test.sdf';
 Pwd='<password>'"
    repl.LoadProperties()

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

try
{
    SqlCeReplication repl = new SqlCeReplication();
    repl.SubscriberConnectionString = "Data Source='Test.sdf'; Pwd='<password>'";
    repl.LoadProperties();

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