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

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)

public void AddSubscription (
    AddOption addOption
)

C++

public:
void AddSubscription (
    AddOption addOption
)

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 の発行者からデータベースの内容をダウンロードします。

値

説明

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

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();
}