SqlCeReplication.AddSubscription Method

Artículo
01/14/2011

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 _
)

public void AddSubscription (
    AddOption addOption
)

public:
void AddSubscription (
    AddOption addOption
)

public void AddSubscription (
    AddOption addOption
)

public function AddSubscription (
    addOption : AddOption
)

Parámetros

addOption

Notas

La replicación de SQL Server Compact 3.5 sólo 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 suscripción 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 sólo 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.

Ejemplo

En este ejemplo se crea una base de datos de suscripción 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();
}

Seguridad para subprocesos

Todos los miembros (Compartidos en Microsoft Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Plataformas

Plataformas de desarrollo

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
Información de la versión
.NET Framework y NET Compact Framework
Se admite en 3.5
.NET Framework
Se admite en 3.0
.NET Compact Framework y .Net Framework
Se admite en 2.0

Vea también

Referencia

SqlCeReplication Class
SqlCeReplication Members
System.Data.SqlServerCe Namespace

Compartir a través de