Freigeben über

SqlCeReplication.AddSubscription-Methode

Hinweis: Dieser Namespace oder Member bzw. diese Klasse wird nur von .NET Framework, Version 1.1, unterstützt.

Erstellt ein neues anonymes Abonnement für eine vorhandene Microsoft SQL Server-Veröffentlichung. Nach dem Aufruf der AddSubscription-Methode muss die Anwendung die Synchronize-Methode aufrufen, um das neue Abonnement anhand des aktuellsten Snapshots mit der Veröffentlichung zu synchronisieren.

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

Parameter

  • addOption

Hinweise

Die SQL Server CE-Replikation unterstützt ausschließlich anonyme Abonnements.

Der Datenbankadministrator muss SQL Server für die Unterstützung von Replikation konfigurieren, die SQL Server-Veröffentlichung erstellen und die Veröffentlichung für anonyme Abonnements aktivieren, bevor eine SQL Server CE-Anwendung die Veröffentlichung abonnieren kann. Der Administrator führt dies im System von SQL Server entweder mit Hilfe der administrativen oder der programmgesteuerten Schnittstellen der SQL Server-Replikation aus.

Der AddOption-Wert gibt die Quelle der neu erstellten SQL Server CE-Abonnementdatenbank an und kann eine der folgenden Konstanten sein:

Wert Beschreibung
CreateDatabase Gibt an, dass die SQL Server CE-Datenbank zunächst erstellt werden muss und dann der Abonnementinhalt über das Netzwerk vom Publisher abgerufen wird. In diesem Fall wird mit dem Aufruf der AddSubscription-Methode und der Synchronize-Methode die SQL Server CE-Datenbank erstellt und der Inhalt der Datenbank vom SQL Server Publisher gedownloadet.
ExistingDatabase Gibt an, dass die Datenbank bereits vorhanden ist, die Inhalte jedoch über das Netzwerk vom Publisher abgerufen werden. In diesem Fall wird mit dem Aufruf der AddSubscription-Methode und der Synchronize-Methode das SQL Server CE-Abonnement erstellt und der Inhalt der Datenbank vom SQL Server Publisher gedownloadet.

AddOption wirkt sich nur darauf aus, wie die SQL Server CE-Datenbank vom SQL Server CE Client Agent anfänglich erstellt und behandelt wird und bestimmt daher, welche Daten vom Server auf das Windows CE-Gerät gedownloadet werden.

Beispiel

[Visual Basic, C#] In diesem Beispiel wird eine neue Abonnementdatenbank erstellt, indem beim Aufruf der AddSubscription-Methode der CreateDatabase-Wert von AddOption übergeben wird.

 
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] Für C++ oder JScript ist kein Beispiel verfügbar. Klicken Sie zum Anzeigen eines Beispiels für Visual Basic oder C# in der linken oberen Ecke der Seite auf die Schaltfläche "Sprachfilter" Sprachfilter.

Anforderungen

Plattformen: .NET Compact Framework - Windows CE .NET

.NET Framework-Sicherheit:

Siehe auch

SqlCeReplication-Klasse | SqlCeReplication-Member | System.Data.SqlServerCe-Namespace

  • Last updated on