SqlCeReplication.AddSubscription Method

Articolo
01/14/2011

Crea una nuova sottoscrizione anonima a una pubblicazione esistente di SQL Server. Dopo la chiamata al metodo AddSubscription, è necessario chiamare il metodo Synchronize attraverso l'applicazione per sincronizzare la nuova sottoscrizione alla pubblicazione sulla base dell'ultimo snapshot.

Spazio dei nomi: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in system.data.sqlserverce.dll)

Sintassi

'Dichiarazione
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
)

Parametri

addOption

Osservazioni

La replica di SQL Server Compact 3.5 supporta solo sottoscrizioni anonime.

È necessario che l'amministratore del database configuri SQL Server per supportare la replica, creare la pubblicazione di SQL Server e abilitare la pubblicazione di sottoscrizioni anonime per consentire ad applicazioni SQL Server Compact 3.5 di effettuare la sottoscrizione alla pubblicazione. Questa operazione viene eseguita sul sistema SQL Server mediante le interfacce a livello di codice o amministrative della replica di SQL Server.

Il valore AddOption specifica l'origine del nuovo database di sottoscrizione di SQL Server Compact 3.5. Il valore può essere una delle seguenti costanti:

Valore	Descrizione
CreateDatabase	Specifica che è necessario innanzitutto creare il database di SQL Server Compact 3.5 e che successivamente sarà possibile ottenere il contenuto della sottoscrizione dall'editore sulla rete. In questo caso, le chiamate ai metodi AddSubscription e Synchronize consentono di creare il database di SQL Server Compact 3.5 e di scaricarne il contenuto dall'editore SQL Server.
ExistingDatabase	Consente di specificare che il database è già presente, ma il contenuto è ottenuto dal server di pubblicazione sulla rete. In questo caso, le chiamate ai metodi AddSubscription e Synchronize consentono di creare la sottoscrizione di SQL Server Compact 3.5 e di scaricare il contenuto del database dall'editore SQL Server.

L'enumerazione AddOption influisce esclusivamente sul modo in cui il database di SQL Server Compact 3.5 viene inizialmente creato e sul modo in cui viene gestito da Agente client di SQL Server Compact 3.5, determinando di conseguenza il tipo di dati scaricati sul dispositivo Windows Mobile dal server.

Esempio

In questo esempio viene creato un nuovo database di sottoscrizione passando il valore CreateDatabase di AddOption in occasione della chiamata al metodo 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();
}

Affidabilità

Tutti i membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono affidabili. Non è invece garantita l'affidabilità dei membri dell'istanza.

Piattaforme

Piattaforme di sviluppo

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
Informazioni sulla versione
.NET Framework e .NET Compact Framework
Supportato in 3.5
.NET Framework
Supportato in 3.0
.NET Compact Framework e .NET Framework
Supportato in 2.0

Vedere anche

Riferimento

SqlCeReplication Class
SqlCeReplication Members
System.Data.SqlServerCe Namespace

Condividi tramite