Subscription.SynchronizationAgentName Property

Gets or sets the name of the agent job created to synchronize the subscription.

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

Syntax

'Declaration
Public Property SynchronizationAgentName As String 
    Get 
    Set
'Usage
Dim instance As Subscription 
Dim value As String 

value = instance.SynchronizationAgentName

instance.SynchronizationAgentName = value
public string SynchronizationAgentName { get; set; }
public:
property String^ SynchronizationAgentName {
    String^ get ();
    void set (String^ value);
}
member SynchronizationAgentName : string with get, set
function get SynchronizationAgentName () : String 
function set SynchronizationAgentName (value : String)

Property Value

Type: System.String
The name of the agent created to synchronize the subscription.

Remarks

The SynchronizationAgentName property is a read/write property on Microsoft SQL Server 2005. It is a ready-only property of Microsoft SQL Server 2000.

SynchronizationAgentName must be set before the subscription is created on the server. Once the subscription registration exists on the server, the SynchronizationAgentName property cannot be changed.

The SynchronizationAgentName property can only be retrieved by members of the sysadmin fixed server role at the Publisher, by members of the db_owner fixed database role on the publication database, or by the user that created the subscription.

The SynchronizationAgentName property can only be set by members of the sysadmin fixed server role at the Publisher or by members of the db_owner fixed database role on the publication database.

Retrieving the SynchronizationAgentName property is equivalent to executing sp_helpsubscription or sp_helpmergesubscription.

Setting the SynchronizationAgentName property is equivalent to executing sp_addpushsubscription_agent or sp_addmergepushsubscription_agent.

See Also

Reference

Subscription Class

Microsoft.SqlServer.Replication Namespace