MergeSubscription Costruttori

Riferimento

Definizione

Spazio dei nomi:: Microsoft.SqlServer.Replication

Assembly:: Microsoft.SqlServer.Rmo.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Crea una nuova istanza della classe MergeSubscription.

Overload

MergeSubscription()	Crea una nuova istanza della classe MergeSubscription.
MergeSubscription(String, String, String, String, ServerConnection)	Crea una nuova istanza della classe MergeSubscription con la connessione al server di pubblicazione specificata e le proprietà che definiscono in modo univoco la sottoscrizione.

Commenti

Testo aggiornato:17 luglio 2006

Nella tabella seguente vengono illustrati i valori delle proprietà predefiniti per una nuova istanza di MergeSubscription. Le proprietà non enumerate in modo esplicito in questa tabella vengono inizializzate in un null valore.

Proprietà	Valore predefinito
AgentOffload	`false`
AgentSchedule	Un valore 99991231 per ActiveEndDate Valore di 235959 per ActiveEndTime Valore 0 per ActiveStartDate Valore 0 per ActiveStartTime Valore 1 per FrequencyInterval Valore 0 per FrequencyRecurrenceFactor Valore di `First` per FrequencyRelativeInterval Valore di `Hour` per FrequencySubDay Valore 1 per FrequencySubDayInterval Valore di `Daily` per FrequencyType
CachePropertyChanges	`false`
CreateSyncAgentByDefault	`true`
EnabledForSynchronizationManager	`false`
IsExistingObject	`false`
Priority	0
PublisherSecurity	Valore di `true` per WindowsAuthentication
Status	Valore di `Inactive` per SubscriptionState
SubscriberSecurity	Valore di `true` per WindowsAuthentication
SubscriberType	Valore di `Local` per MergeSubscriberType
SubscriptionType	Valore di `Push` per SubscriptionOption
SynchronizationAgent	Istanza della MergeSynchronizationAgent pubblicazione associata alla sottoscrizione creata.
SyncType	Valore di `Automatic` per SubscriptionSyncType
UseInteractiveResolver	`false`

MergeSubscription()

Crea una nuova istanza della classe MergeSubscription.

public:
 MergeSubscription();

public MergeSubscription ();

Public Sub New ()

Esempio

// Define the Publisher, publication, and databases.
string publicationName = "AdvWorksSalesOrdersMerge";
string publisherName = publisherInstance;
string subscriberName = subscriberInstance;
string subscriptionDbName = "AdventureWorks2012Replica";
string publicationDbName = "AdventureWorks2012";
string hostname = @"adventure-works\garrett1";

//Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);

// Create the objects that we need.
MergePublication publication;
MergeSubscription subscription;

try
{
    // Connect to the Publisher.
    conn.Connect();

    // Ensure that the publication exists and that 
    // it supports push subscriptions.
    publication = new MergePublication();
    publication.Name = publicationName;
    publication.DatabaseName = publicationDbName;
    publication.ConnectionContext = conn;

    if (publication.IsExistingObject)
    {
        if ((publication.Attributes & PublicationAttributes.AllowPush) == 0)
        {
            publication.Attributes |= PublicationAttributes.AllowPush;
        }

        // Define the push subscription.
        subscription = new MergeSubscription();
        subscription.ConnectionContext = conn;
        subscription.SubscriberName = subscriberName;
        subscription.PublicationName = publicationName;
        subscription.DatabaseName = publicationDbName;
        subscription.SubscriptionDBName = subscriptionDbName;
        subscription.HostName = hostname;

        // Set a schedule to synchronize the subscription every 2 hours
        // during weekdays from 6am to 10pm.
        subscription.AgentSchedule.FrequencyType = ScheduleFrequencyType.Weekly;
        subscription.AgentSchedule.FrequencyInterval = Convert.ToInt32(0x003E);
        subscription.AgentSchedule.FrequencyRecurrenceFactor = 1;
        subscription.AgentSchedule.FrequencySubDay = ScheduleFrequencySubDay.Hour;
        subscription.AgentSchedule.FrequencySubDayInterval = 2;
        subscription.AgentSchedule.ActiveStartDate = 20051108;
        subscription.AgentSchedule.ActiveEndDate = 20071231;
        subscription.AgentSchedule.ActiveStartTime = 060000;
        subscription.AgentSchedule.ActiveEndTime = 100000;

        // Specify the Windows login credentials for the Merge Agent job.
        subscription.SynchronizationAgentProcessSecurity.Login = winLogin;
        subscription.SynchronizationAgentProcessSecurity.Password = winPassword;

        // Create the push subscription.
        subscription.Create();
    }
    else
    {
        // Do something here if the publication does not exist.
        throw new ApplicationException(String.Format(
            "The publication '{0}' does not exist on {1}.",
            publicationName, publisherName));
    }
}
catch (Exception ex)
{
    // Implement the appropriate error handling here.
    throw new ApplicationException(String.Format(
        "The subscription to {0} could not be created.", publicationName), ex);
}
finally
{
    conn.Disconnect();
}

' Define the Publisher, publication, and databases.
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publisherName As String = publisherInstance
Dim subscriberName As String = subscriberInstance
Dim subscriptionDbName As String = "AdventureWorks2012Replica"
Dim publicationDbName As String = "AdventureWorks2012"
Dim hostname As String = "adventure-works\garrett1"

'Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)

' Create the objects that we need.
Dim publication As MergePublication
Dim subscription As MergeSubscription

Try
    ' Connect to the Publisher.
    conn.Connect()

    ' Ensure that the publication exists and that 
    ' it supports push subscriptions.
    publication = New MergePublication()
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName
    publication.ConnectionContext = conn

    If publication.IsExistingObject Then
        If (publication.Attributes And PublicationAttributes.AllowPush) = 0 Then
            publication.Attributes = publication.Attributes _
            Or PublicationAttributes.AllowPush
        End If

        ' Define the push subscription.
        subscription = New MergeSubscription()
        subscription.ConnectionContext = conn
        subscription.SubscriberName = subscriberName
        subscription.PublicationName = publicationName
        subscription.DatabaseName = publicationDbName
        subscription.SubscriptionDBName = subscriptionDbName
        subscription.HostName = hostname

        ' Set a schedule to synchronize the subscription every 2 hours
        ' during weekdays from 6am to 10pm.
        subscription.AgentSchedule.FrequencyType = ScheduleFrequencyType.Weekly
        subscription.AgentSchedule.FrequencyInterval = Convert.ToInt32("0x003E", 16)
        subscription.AgentSchedule.FrequencyRecurrenceFactor = 1
        subscription.AgentSchedule.FrequencySubDay = ScheduleFrequencySubDay.Hour
        subscription.AgentSchedule.FrequencySubDayInterval = 2
        subscription.AgentSchedule.ActiveStartDate = 20051108
        subscription.AgentSchedule.ActiveEndDate = 20071231
        subscription.AgentSchedule.ActiveStartTime = 60000
        subscription.AgentSchedule.ActiveEndTime = 100000

        ' Specify the Windows login credentials for the Merge Agent job.
        subscription.SynchronizationAgentProcessSecurity.Login = winLogin
        subscription.SynchronizationAgentProcessSecurity.Password = winPassword

        ' Create the push subscription.
        subscription.Create()
    Else

        ' Do something here if the publication does not exist.
        Throw New ApplicationException(String.Format( _
         "The publication '{0}' does not exist on {1}.", _
         publicationName, publisherName))
    End If
Catch ex As Exception
    ' Implement the appropriate error handling here.
    Throw New ApplicationException(String.Format( _
    "The subscription to {0} could not be created.", publicationName), ex)
Finally
    conn.Disconnect()
End Try

Commenti

Il costruttore predefinito inizializza tutti i campi in base ai valori predefiniti.

Vedi anche

Procedura: Creazione di una sottoscrizione push (programmazione RMO)

Si applica a

MergeSubscription(String, String, String, String, ServerConnection)

Crea una nuova istanza della classe MergeSubscription con la connessione al server di pubblicazione specificata e le proprietà che definiscono in modo univoco la sottoscrizione.

public:
 MergeSubscription(System::String ^ publicationName, System::String ^ databaseName, System::String ^ subscriberName, System::String ^ subscriptionDBName, Microsoft::SqlServer::Management::Common::ServerConnection ^ connectionContext);

public MergeSubscription (string publicationName, string databaseName, string subscriberName, string subscriptionDBName, Microsoft.SqlServer.Management.Common.ServerConnection connectionContext);

new Microsoft.SqlServer.Replication.MergeSubscription : string * string * string * string * Microsoft.SqlServer.Management.Common.ServerConnection -> Microsoft.SqlServer.Replication.MergeSubscription

Public Sub New (publicationName As String, databaseName As String, subscriberName As String, subscriptionDBName As String, connectionContext As ServerConnection)

Parametri

publicationName: String

Valore String che specifica il nome della pubblicazione di tipo merge.

databaseName: String

Valore String che specifica il nome del database che contiene la pubblicazione.

subscriberName: String

Valore String che specifica il nome del Sottoscrittore che sottoscrive la pubblicazione.

subscriptionDBName: String

Valore String che specifica il nome del database di sottoscrizione.

connectionContext: ServerConnection

Valore dell'oggetto ServerConnection che specifica la connessione al server di pubblicazione.

Si applica a