SqlCeReplication.AddSubscription メソッド

メモ : この名前空間、クラス、およびメンバは、.NET Framework Version 1.1 だけでサポートされています。

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

Public Sub AddSubscription( _
   ByVal addOption As AddOption _)
[C#]
public void AddSubscription(AddOptionaddOption);
[C++]
public: void AddSubscription(AddOptionaddOption);
[JScript]
public function AddSubscription(
   addOption : AddOption);

パラメータ

• addOption

解説

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

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

AddOption 値で、新しく作成される SQL Server CE サブスクリプション データベースのソースを指定します。この値に使用できる定数を次に示します。

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

使用例

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

 
Dim repl As SqlCeReplication = Nothing

Try
   ' Set the Replication object
   repl = New SqlCeReplication()
   repl.InternetUrl       = "<http://www.northwindtraders.com/sqlce/sscesa20.dll>"
   repl.InternetLogin     = "MyLogin"
   repl.InternetPassword  = "<password>"
   repl.Publisher         = "MyPublisher"
   repl.PublisherDatabase = "MyPublisher Database"
   repl.PublisherLogin    = "MyPublisher Login"
   repl.PublisherPassword = "<password>"
   repl.Publication       = "MyPublication"
   repl.Subscriber        = "MySub"
   repl.SubscriberConnectionString = "Provider=Microsoft.SQLSERVER.OLEDB.CE.2.0;Data Source=\ssce.sdf"
   
   ' Create the Local SSCE Database subscription
   repl.AddSubscription(AddOption.CreateDatabase)
   
   ' Synchronize to the SQL Server 2000 to populate the Subscription 
   repl.Synchronize()

Catch e As SqlCeException
' Use your own error handling routine to show error information.
' ShowError.ShowErrors(e);

Finally
   ' Dispose of the Replication Object
   repl.Dispose()
End Try

[C#] 

        SqlCeReplication repl = null;

        try {
            // Set the Replication object
            repl = new SqlCeReplication();
            repl.InternetUrl       = "<http://www.northwindtraders.com/sqlce/sscesa20.dll>";
            repl.InternetLogin     = "MyLogin";
            repl.InternetPassword  = "<password>";
            repl.Publisher         = "MyPublisher";
            repl.PublisherDatabase = "MyPublisher Database";
            repl.PublisherLogin    = "MyPublisher Login";
            repl.PublisherPassword = "<password>";
            repl.Publication       = "MyPublication";
            repl.Subscriber        = "MySub"; 
            repl.SubscriberConnectionString = "Provider=Microsoft.SQLSERVER.OLEDB.CE.2.0;Data Source=\\ssce.sdf";

            // Create the Local SSCE Database subscription
            repl.AddSubscription(AddOption.CreateDatabase);

            // Synchronize to the SQL Server 2000 to populate the Subscription 
            repl.Synchronize();
        }
   
        catch(SqlCeException) {
            // Use your own error handling routine to show error information.
        }

        finally {
            // Dispose of the Replication Object
            repl.Dispose();
        }

[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: .NET Compact Framework - Windows CE .NET

.NET Framework セキュリティ:

• 直前の呼び出し元の完全信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細の参照先 : 部分信頼コードからのライブラリの使用

参照

SqlCeReplication クラス | SqlCeReplication メンバ | System.Data.SqlServerCe 名前空間