次の方法で共有

SqlCeReplication.AddSubscription Method

  • [アーティクル]

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

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

構文

'宣言
Public Sub AddSubscription ( _
    addOption As AddOption _
)

public void AddSubscription (
    AddOption addOption
)

public:
void AddSubscription (
    AddOption addOption
)

public void AddSubscription (
    AddOption addOption
)

public function AddSubscription (
    addOption : AddOption
)

パラメータ

  • 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 サブスクリプション データベースのソースを示します。値は、次の定数のいずれかになります。

値

説明

CreateDatabase

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

ExistingDatabase

データベースは既に存在するが内容はネットワーク経由でパブリッシャから取得することを示します。この場合は、AddSubscription メソッドと Synchronize メソッドを呼び出して、SQL Server Compact 3.5 サブスクリプションを作成し、SQL Server のパブリッシャからデータベースの内容をダウンロードします。

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

スレッド セーフ

この型の public static (Visual Basic では Shared ) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

開発プラットフォーム

Windows Vista、Windows Mobile 5.0、Windows XP Professional with Service Pack 2 (SP2)、Windows Server 2003、Windows Mobile 2003 for Pocket PC、Windows CE 5.0
バージョン情報
.NET Framework および .NET Compact Framework
3.5 でサポート
.NET Framework
3.0 でサポート
.NET Compact Framework および .Net Framework
2.0 でサポート

参照

リファレンス

SqlCeReplication Class
SqlCeReplication Members
System.Data.SqlServerCe Namespace