AddSubscription Método
Crea una nueva suscripción anónima para una publicación existente de SQL Server. Después de llamar al método AddSubscription, la aplicación debe llamar al método Synchronize para sincronizar la nueva suscripción con la publicación en función de la instantánea más reciente.
Espacio de nombres: System.Data.SqlServerCe
Ensamblado: System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)
Sintaxis
'Declaración
Public Sub AddSubscription ( _
addOption As AddOption _
)
'Uso
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
)
Parámetros
- addOption
Tipo: System.Data.SqlServerCe. . :: . .AddOption
Notas
La replicación de SQL Server Compact 3.5 solo admite suscripciones anónimas.
El administrador de la base de datos debe configurar SQL Server de modo que admita la replicación, cree la replicación de SQL Server y habilite la publicación de suscripciones anónimas para que cualquier aplicación de SQL Server Compact 3.5 se pueda suscribir a la publicación. El administrador puede hacer esto en el sistema SQL Server mediante las interfaces administrativas o de programación de replicaciones de SQL Server.
El valor de AddOption especifica el origen de la base de datos de suscripciones de SQL Server Compact 3.5 recién creada. El valor puede ser una de las constantes siguientes:
Valor |
Description |
---|---|
CreateDatabase |
Especifica que se debe crear la base de datos de SQL Server Compact 3.5 en primer lugar y, a continuación, se obtendrá el contenido de suscripción del publicador a través de la red. En este caso, las llamadas a los métodos AddSubscription y Synchronize crean la base de datos de SQL Server Compact 3.5 y descargan el contenido de la base de datos del publicador de SQL Server. |
ExistingDatabase |
Especifica que la base de datos ya existe pero el contenido se obtiene del publicador a través de la red. En este caso, las llamadas a los métodos AddSubscription y Synchronize crean la suscripción de SQL Server Compact 3.5 y descargan el contenido de la base de datos del publicador de SQL Server. |
AddOption solo afecta a cómo se crea inicialmente la base de datos de SQL Server Compact 3.5 y cómo la trata el agente del cliente SQL Server Compact 3.5, por lo que determina qué datos se descargan desde el servidor al dispositivo Windows Mobile.
Ejemplos
En este ejemplo se crea una base de datos de suscripciones nueva. Para ello, se pasa el valor CreateDatabase de AddOption al llamar al método 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();
}