SqlCeReplication.SaveProperties メソッド

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

SqlCeReplication.SaveProperties メソッド

現在のサブスクリプションについて Replication クラス プロパティ内に格納されたすべての値を取得し、システム テーブルに格納します。

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

Visual Basic (宣言)

Public Sub SaveProperties

Visual Basic (使用法)

Dim instance As SqlCeReplication

instance.SaveProperties

C#

public void SaveProperties ()

C++

public:
void SaveProperties ()

J#

public void SaveProperties ()

JScript

public function SaveProperties ()

解説

サブスクリプションを正しく作成してから、同期プロパティを保存します。SaveProperties 呼び出しを正常に実行するには、同期の実行に必要なすべてのパラメータを指定する必要があります。同期プロパティの保存時に不要なパラメータを除外すると、保存された同期プロパティが既に存在していても、これらのパラメータが既定値に設定されます。プロパティの上書きを防止するには、ユーザーがまず LoadProperties を呼び出して同期プロパティを取得し、特定のプロパティを変更して、その同期プロパティを再度保存する必要があります。

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

使用例

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

Visual Basic

Dim repl As SqlCeReplication = Nothing

Try
    ' Create SqlCeReplication instance
    '
    repl = New SqlCeReplication()
    repl.InternetUrl = "http://www.adventure-works.com/sqlmobile/sqlcesa30.dll"
    repl.InternetLogin = "MyInternetLogin"
    repl.InternetPassword = "<password>"
    repl.Publisher = "MyPublisher"
    repl.PublisherDatabase = "MyPublisherDatabase"
    repl.PublisherLogin = "MyPublisherLogin"
    repl.PublisherPassword = "<password>"
    repl.Publication = "MyPublication"
    repl.Subscriber = "MySubscriber"
    repl.SubscriberConnectionString = "Data Source=MyDatabase.sdf"

    ' Store all the properties in the database
    '
    repl.SaveProperties()

    ' In the future all you need to do is load the properties
    '
    repl = New SqlCeReplication()
    repl.SubscriberConnectionString = "Data Source='Test.sdf';
 Pwd='<password>'"
    repl.LoadProperties()

    ' Now the SqlCeReplication instance is ready to sync
    '
    repl.Synchronize()

Catch
    ' Handle errors here
Finally
    ' Dispose the repl object
    '
    repl.Dispose()
End Try

C#

SqlCeReplication repl = null;

try
{
    // Create SqlCeReplication instance
    //
    repl = new SqlCeReplication();
    repl.InternetUrl = "http://www.adventure-works.com/sqlmobile/sqlcesa30.dll";
    repl.InternetLogin = "MyInternetLogin";
    repl.InternetPassword = "<password>";
    repl.Publisher = "MyPublisher";
    repl.PublisherDatabase = "MyPublisherDatabase";
    repl.PublisherLogin = "MyPublisherLogin";
    repl.PublisherPassword = "<password>";
    repl.Publication = "MyPublication";
    repl.Subscriber = "MySubscriber";
    repl.SubscriberConnectionString = "Data Source=MyDatabase.sdf";

    // Store all the properties in the database
    //
    repl.SaveProperties();

    // In the future all you need to do is load the properties
    //
    repl = new SqlCeReplication();
    repl.SubscriberConnectionString = "Data Source='Test.sdf'; Pwd='<password>'";
    repl.LoadProperties();

    // Now the SqlCeReplication instance is ready to sync
    //
    repl.Synchronize();

}
catch (SqlCeException)
{
    // Handle errors here
}
finally
{
    // Dispose the repl object
    //
    repl.Dispose();
}

.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 名前空間