SqlCeReplication.AddSubscription メソッド

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

SqlCeReplication.AddSubscription メソッド

既存の Microsoft SQL Server パブリケーションに、新しい匿名サブスクリプションを作成します。AddSubscription メソッドを呼び出した後で、アプリケーションで Synchronize メソッドを呼び出して、最新のスナップショットに基づいて、新しいサブスクリプションをパブリケーションに同期させる必要があります。

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

Visual Basic (宣言)

Public Sub AddSubscription ( _
    addOption As AddOption _
)

Visual Basic (使用法)

Dim instance As SqlCeReplication
Dim addOption As AddOption

instance.AddSubscription(addOption)

C#

public void AddSubscription (
    AddOption addOption
)

C++

public:
void AddSubscription (
    AddOption addOption
)

J#

public void AddSubscription (
    AddOption addOption
)

JScript

public function AddSubscription (
    addOption : AddOption
)

パラメータ

addOption

解説

SQL Server Mobile のレプリケーションでは、匿名サブスクリプションだけをサポートします。

データベース管理者は、SQL Server Mobile アプリケーションがパブリケーションをサブスクライブする前に、レプリケーションをサポートするように SQL Server を設定し、SQL Server のパブリケーションを作成して、そのパブリケーションを匿名サブスクリプションで使用できるように必要があります。システム管理者は、この作業を SQL Server システムに対して実行するために、SQL Server レプリケーションの管理用インターフェイス、またはプログラミング インターフェイスのいずれかを使用します。

AddOption の値は、新しく作成する SQL Server Mobile サブスクリプション データベースのソースを示します。値は、次の定数のいずれかになります。

値	説明
CreateDatabase	最初に SQL Server Mobile データベースを作成し、次にサブスクリプションの内容をネットワーク経由で発行者から取得する必要があることを示します。この場合は、AddSubscription メソッドと Synchronize メソッドを呼び出して SQL Server Mobile データベースを作成し、SQL Server の発行者からデータベースの内容をダウンロードします。
ExistingDatabase	データベースは既に存在するが内容はネットワーク経由で発行者から取得することを示します。この場合は、AddSubscription メソッドと Synchronize メソッドを呼び出して SQL Server Mobile サブスクリプションを作成し、SQL Server の発行者からデータベースの内容をダウンロードします。

AddOption は、最初に SQL Server Mobile データベースを作成する方法と SQL Server Mobile クライアント エージェントの処理方法にだけ影響します。これにより、サーバーから Windows Mobile デバイスにダウンロードされるデータが決まります。

使用例

この例では、AddSubscription メソッドの呼び出し時に、AddOption の CreateDatabase 値を渡して、新しいサブスクリプション データベースを作成します。

Visual Basic

Dim repl As SqlCeReplication = Nothing

Try
    ' Instantiate and configure SqlCeReplication object
    '
    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"

    ' Create the local SQL Mobile Database subscription
    '
    repl.AddSubscription(AddOption.CreateDatabase)

    ' Synchronize to the SQL Server to populate the Subscription 
    '
    repl.Synchronize()
Catch
    ' Handle errors here
    '
Finally
    ' Dispose the repl object
    '
    repl.Dispose()
End Try

C#

SqlCeReplication repl = null;

try
{
    // Instantiate and configure SqlCeReplication object
    //
    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";

    // Create a local SQL Mobile Database subscription
    //
    repl.AddSubscription(AddOption.CreateDatabase);

    // Synchronize to the SQL Server database
    //
    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、1.0

参照

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