AddSubscription メソッド

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

名前空間:  System.Data.SqlServerCe
アセンブリ:  System.Data.SqlServerCe (System.Data.SqlServerCe.dll)

構文

'宣言
Public Sub AddSubscription ( _
    addOption As AddOption _
)
'使用
Dim instance As SqlCeReplication
Dim addOption As AddOption

instance.AddSubscription(addOption)

public void AddSubscription(
    AddOption addOption
)

public:
void AddSubscription(
    AddOption addOption
)

member AddSubscription : 
        addOption:AddOption -> unit 

public function AddSubscription(
    addOption : AddOption
)

パラメーター

• addOption
  型: System.Data.SqlServerCe. . :: . .AddOption

説明

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

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

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

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

使用例

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

Dim repl As SqlCeReplication = Nothing

Try
    ' Instantiate and configure SqlCeReplication object
    '
    'NOTE: when possible, prompt users to enter security 
    'credentials at runtime. If you store credentials in a file, 
    'you must secure the file to prevent unauthorized access.
    '
    repl = New SqlCeReplication()
    repl.InternetUrl = "https://www.adventure-works.com/sqlce/sqlcesa35.dll"
    repl.InternetLogin = "MyInternetLogin"
    repl.InternetPassword = "<enterStrongPassword>"
    repl.Publisher = "MyPublisher"
    repl.PublisherDatabase = "MyPublisherDatabase"
    repl.PublisherLogin = "MyPublisherLogin"
    repl.PublisherPassword = "<enterStrongPassword>"
    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
    //
    //NOTE: when possible, prompt users to enter security 
    //credentials at runtime. If you store credentials in a file, 
    //you must secure the file to prevent unauthorized access.
    //
    repl = new SqlCeReplication();
    repl.InternetUrl = "https://www.adventure-works.com/sqlce/sqlcesa35.dll";
    repl.InternetLogin = "MyInternetLogin";
    repl.InternetPassword = "<enterStrongPassword>";
    repl.Publisher = "MyPublisher";
    repl.PublisherDatabase = "MyPublisherDatabase";
    repl.PublisherLogin = "MyPublisherLogin";
    repl.PublisherPassword = "<enterStrongPassword>";
    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();
}

関連項目

参照

SqlCeReplication クラス

SqlCeReplication メンバー

System.Data.SqlServerCe 名前空間