TransPublications Collection

SQL-DMO

SQL-DMO

TransPublications Collection

The TransPublications collection contains TransPublication objects that reference Microsoft® SQL Server™ transactional and snapshot replication publications.

Properties
Count Property  
Methods
Add Method Script Method (Replication Objects)
Item Method Refresh Method
ItemByID Method Remove Method (Collections)

Remarks

With the TransPublications object, you can:

  • Create a transactional or snapshot replication publication.

  • Generate a Transact-SQL script that can be used as part of the administration of all transactional or snapshot publications defined on an instance of SQL Server.

  • Remove a transactional or snapshot replication publication.

To remove a transactional or snapshot replication publication

  1. Get a TransPublication object from the TransPublications collection of a connected ReplicationDatabase object.

  2. For each TransSubscription object in the TransSubscriptions collection, test the SubscriptionType property. If the SubscriptionType property value for all referenced subscriptions is SQLDMOSubscription_Push, you can safely remove the referenced transactional or snapshot replication publication. If pull subscriptions are defined on the publication, take appropriate action to disable the pull subscription at the Subscriber prior to removing the publication.

  3. Use the Remove method of the TransPublication object to remove the  referenced publication.

    Note  Removing a publication by using the Remove method of a TransPublication or MergePublication object removes all article definitions and all known subscription entries. Removing a publication does not remove a replicated copy of the publication articles at any Subscriber.

When using the Item or Remove method, the TransPublications collection supports member identification using either name or ordinal reference syntax. For example:

Set oTransPublication = _ 
oReplicationDatabase.TransPublications("[Northwind_Snap]")

Or:

Set oTransPublication = oReplicationDatabase.TransPublications(7)