AddSubscription méthode
Crée un abonnement anonyme à une publication SQL Server existante. Après l'appel de la méthode AddSubscription, l'application doit appeler la méthode Synchronize afin de synchroniser le nouvel abonnement en fonction du dernier instantané.
Espace de noms : System.Data.SqlServerCe
Assembly : System.Data.SqlServerCe (dans System.Data.SqlServerCe.dll)
Syntaxe
'Déclaration
Public Sub AddSubscription ( _
addOption As AddOption _
)
'Utilisation
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
)
Paramètres
- addOption
Type : System.Data.SqlServerCe. . :: . .AddOption
Notes
La réplication SQL Server Compact 3.5 prend en charge uniquement les abonnements anonymes.
L'administrateur de la base de données doit configurer SQL Server pour prendre en charge la réplication, créer la publication SQL Server et activer la publication pour des abonnements anonymes avant qu'une application SQL Server Compact 3.5 puisse s'abonner à la publication. L'administrateur réalise cette opération sur le système SQL Server en utilisant les interfaces de programmation ou d'administration de la réplication SQL Server.
La valeur AddOption spécifie la source de la base de données d'abonnement SQL Server Compact 3.5 nouvellement créée. La valeur peut être l'une des constantes suivantes :
Valeur |
Description |
|---|---|
CreateDatabase |
Spécifie que la base de données SQL Server Compact 3.5 doit d'abord être créée et le contenu de l'abonnement est ensuite obtenu auprès du serveur de publication via le réseau. Dans ce cas, les appels aux méthodes AddSubscription et Synchronize créent la base de données SQL Server Compact 3.5 et téléchargent le contenu de la base de données à partir du serveur de publication SQL Server. |
ExistingDatabase |
Spécifie que la base de données existe déjà mais que le contenu est obtenu auprès du serveur de publication sur le réseau. Dans ce cas, les appels aux méthodes AddSubscription et Synchronize créent l'abonnement SQL Server Compact 3.5 et téléchargent le contenu de la base de données à partir du serveur de publication SQL Server. |
AddOption affecte uniquement la manière dont la base de données SQL Server Compact 3.5 est créée initialement et traitée par l'agent client SQL Server Compact 3.5 ; par conséquent, il détermine les données qui sont téléchargées sur le périphérique Windows Mobile à partir du serveur.
Exemples
Cet exemple crée une nouvelle base de données d'abonnement en passant la valeur CreateDatabase de AddOption lors de l'appel à la méthode AddSubscription.
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();
}