Share via


Subscription.CreateSyncAgentByDefault Property

Definition

Gets or sets whether the agent job used to synchronize the subscription is created by default.

public:
 property bool CreateSyncAgentByDefault { bool get(); void set(bool value); };
public bool CreateSyncAgentByDefault { get; set; }
member this.CreateSyncAgentByDefault : bool with get, set
Public Property CreateSyncAgentByDefault As Boolean

Property Value

A Boolean value. If true, the agent job is created. If false, the agent job is not created.

Remarks

The CreateSyncAgentByDefault property is only used when a new subscription is created.

The default value for CreateSyncAgentByDefault is true.

When an agent job is created, metadata required by Microsoft SQL Server Agent to synchronize the subscription is stored in the MSsubscription_properties table. When you create a subscription and specify a value of false for CreateSyncAgentByDefault, a data row is not added to the MSsubscription_properties table for the subscription. In this case, many of the properties of the MergeSubscription or TransSubscription object that represent a subscription cannot be saved on the server. To persist any of the subscription properties in the MSsubscription_properties table, you must specify a value of true for CreateSyncAgentByDefault.

Applies to

See also