• Article

TransPublications Collection

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

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

SQL-DMO object model that shows the current object

Properties

Count Property

 

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 TransSubscriptionscollection, 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 TransPublicationor 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)