DistributionSubscription Class

Represents information stored at the Distributor about a subscription to a transactional or snapshot publication.

Inheritance Hierarchy

System.Object
  Microsoft.SqlServer.Replication.ReplicationObject
    Microsoft.SqlServer.Replication.DistributionSubscription

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

Syntax

'Declaration
Public NotInheritable Class DistributionSubscription _
    Inherits ReplicationObject
'Usage
Dim instance As DistributionSubscription
public sealed class DistributionSubscription : ReplicationObject
public ref class DistributionSubscription sealed : public ReplicationObject
[<SealedAttribute>]
type DistributionSubscription =  
    class
        inherit ReplicationObject
    end
public final class DistributionSubscription extends ReplicationObject

The DistributionSubscription type exposes the following members.

Constructors

  Name Description
Public method DistributionSubscription() Creates a new instance of the DistributionSubscription class.
Public method DistributionSubscription(String, String, String, String, String, String, ServerConnection) Creates a new instance of the DistributionSubscription class, with the required properties and with a connection to the Distributor.

Top

Properties

  Name Description
Public property AgentJobId Gets the ID of the SQL Server Agent job that synchronizes the Subscription. 
Public property AgentSchedule Gets the synchronization agent schedule for the subscription.
Public property CachePropertyChanges Gets or sets whether to cache changes made to the replication properties or to apply them immediately. (Inherited from ReplicationObject.)
Public property ConnectionContext Gets or sets the connection to an instance of Microsoft SQL Server. (Inherited from ReplicationObject.)
Public property DistributionAgent Gets the name of the SQL Server Agent job that is used to synchronize the subscription. 
Public property DistributionDBName Gets or sets the name of the distribution database.
Public property IsExistingObject Gets whether the object exists on the server or not. (Inherited from ReplicationObject.)
Public property Name Gets the name of the subscription.
Public property PublicationDBName Gets or sets the name of the publication database.
Public property PublicationName Gets or sets the name of the publication to which the subscription belongs.
Public property PublisherName Gets or sets the Publisher of the publication to which the subscription belongs.
Public property SqlServerName Gets the name of the Microsoft SQL Server instance to which this object is connected. (Inherited from ReplicationObject.)
Public property Status Gets or sets the status of the subscription.
Public property SubscriberName Gets or sets the name of the Subscriber.
Public property SubscriptionDBName Gets or sets the name of the subscription database.
Public property SubscriptionType Gets or sets whether the Distribution agent runs at the Distributor (Push) or at the Subscriber (Pull).
Public property SyncType Gets or sets the manner in which the subscription is initialized.
Public property UserData Gets or sets an object property that allows users to attach their own data to the object. (Inherited from ReplicationObject.)

Top

Methods

  Name Description
Protected method CheckValidCreation Infrastructure. (Inherited from ReplicationObject.)
Protected method CheckValidDefinition Infrastructure. (Inherited from ReplicationObject.)
Public method CommitPropertyChanges Sends all the cached property change statements to the instance of Microsoft SQL Server. (Inherited from ReplicationObject.)
Public method Decouple Decouples the referenced replication object from the server. (Inherited from ReplicationObject.)
Public method Equals (Inherited from Object.)
Protected method Finalize (Inherited from Object.)
Protected method GetChangeCommand Infrastructure. (Inherited from ReplicationObject.)
Protected method GetCreateCommand Infrastructure. (Inherited from ReplicationObject.)
Protected method GetDropCommand Infrastructure. (Inherited from ReplicationObject.)
Public method GetHashCode (Inherited from Object.)
Public method GetType (Inherited from Object.)
Protected method InternalRefresh Infrastructure. (Inherited from ReplicationObject.)
Public method Load Loads the properties of an existing object from the server. (Inherited from ReplicationObject.)
Public method LoadProperties Loads the properties of an existing object from the server. (Inherited from ReplicationObject.)
Protected method MemberwiseClone (Inherited from Object.)
Public method Refresh Reloads the properties of the object. (Inherited from ReplicationObject.)
Public method Script Infrastructure.
Public method ToString (Inherited from Object.)

Top

Remarks

The DistributionSubscription class is primarily used by SQL Server Management Studio to maintain subscriptions to non-SQL Server Publications. Use an instance of the TransSubscription or class to obtain information on subscriptions registered with a SQL Server Publisher.

The DistributionSubscription class can only be used to return information about an existing subscription. You must use an instance of the TransSubscription class to create or remove a subscription to a transactional or snapshot publication.

This namespace, class, or member is supported only in version 2.0 of the .NET Framework.

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are safe for multithreaded operations. Any instance members are not guaranteed to be thread safe.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.