• Article

MergePullSubscription Constructor (String, String, String, String, ServerConnection, Boolean)

Creates a new instance of the MergePullSubscription class with the specified database, Publisher, publication, Subscriber connection, and whether the agent job is created.

Namespace:  Microsoft.SqlServer.Replication
Assembly:  Microsoft.SqlServer.Rmo (in Microsoft.SqlServer.Rmo.dll)

Syntax

'Declaration
Public Sub New ( _
    subscriptionDBName As String, _
    publisherName As String, _
    publicationDBName As String, _
    publicationName As String, _
    subscriberConnectionContext As ServerConnection, _
    createMergeAgentByDefault As Boolean _
)
'Usage
Dim subscriptionDBName As String
Dim publisherName As String
Dim publicationDBName As String
Dim publicationName As String
Dim subscriberConnectionContext As ServerConnection
Dim createMergeAgentByDefault As Boolean

Dim instance As New MergePullSubscription(subscriptionDBName, _
    publisherName, publicationDBName, _
    publicationName, subscriberConnectionContext, _
    createMergeAgentByDefault)

public MergePullSubscription(
    string subscriptionDBName,
    string publisherName,
    string publicationDBName,
    string publicationName,
    ServerConnection subscriberConnectionContext,
    bool createMergeAgentByDefault
)

public:
MergePullSubscription(
    String^ subscriptionDBName, 
    String^ publisherName, 
    String^ publicationDBName, 
    String^ publicationName, 
    ServerConnection^ subscriberConnectionContext, 
    bool createMergeAgentByDefault
)

new : 
        subscriptionDBName:string * 
        publisherName:string * 
        publicationDBName:string * 
        publicationName:string * 
        subscriberConnectionContext:ServerConnection * 
        createMergeAgentByDefault:bool -> MergePullSubscription

public function MergePullSubscription(
    subscriptionDBName : String, 
    publisherName : String, 
    publicationDBName : String, 
    publicationName : String, 
    subscriberConnectionContext : ServerConnection, 
    createMergeAgentByDefault : boolean
)

Parameters

  • subscriptionDBName
    Type: System.String
    A String value that specifies the name of the subscription database.
  • publicationDBName
    Type: System.String
    A String value that specifies the name of the publication database.
  • publicationName
    Type: System.String
    A String value that specifies the name of the publication.
  • createMergeAgentByDefault
    Type: System.Boolean
    Specifies whether or not the agent job for the subscription is created when the subscription is created.

Remarks

Specify a value of true for createMergeAgentByDefault when you need to schedule synchronization, or when you need to synchronize the subscription from SQL Server Management Studio. Specify a value of false if the Replication Agent will always be started programmatically without using SQL Server Agent.

When you specify a value of false for createMergeAgentByDefault, the MergeSynchronizationAgent or TransSynchronizationAgent objects obtained from the SynchronizationAgent property will not have enough information to successfully synchronize the subscription. For more information, see How to: Synchronize a Pull Subscription (RMO Programming).