SqlCeReplication.LoadProperties メソッド

.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

C#

public bool LoadProperties ()

C++

public:
bool LoadProperties ()

J#

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

C#

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

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

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows XP Professional x64 Edition, Windows XP SP2

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
SqlCeReplication クラス
SqlCeReplication メンバ
System.Data.SqlServerCe 名前空間