Partager via


TransArticle Object

Cette fonctionnalité sera supprimée dans une prochaine version de Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité.

The TransArticle object represents a table or a stored procedure published using a transactional or a snapshot publication.

Modèle objet SQL-DMO qui affiche l'objet en cours

Notes

With the TransArticle object, you can:

  • Add a table or stored procedure article to a transactional publication.

  • Change the properties of an existing table or stored procedure article of a transactional publication.

  • Add a table or stored procedure article to a snapshot publication.

  • Change the properties of an existing table or stored procedure article of a snapshot publication.

Notes

The TransArticle object is compatible with instances of SQL Server versions 7.0 and later. However, the TransArticle2 object extends the functionality of the TransArticle object for use with features that were introduced in SQL Server 2000.

To add a table article to a transactional publication

  1. Create a new TransArticle object.

  2. Set the Name property to the name of the new article.

  3. Set the SourceObjectName property to the name of a table.

  4. Set the SourceObjectOwner property to the owner of the table.

  5. Add the TransArticle object to the TransArticles collection of a connected TransPublication object containing a transactional publication.

To add a stored procedure article to a transactional publication

  1. Create a new TransArticle object.

  2. Set the Name property to the name of the new article.

  3. Set the SourceObjectName property to the name of a stored procedure.

  4. Set the SourceObjectOwner property to the owner of the stored procedure.

  5. Set the ArticleType property to SQLDMORep_ProcExecution or SQLDMORep_SerializableProcExecution.

  6. Set the CreationScriptOptions property to SQLDMOCreationScript_PrimaryObject.

  7. Add the TransArticle object to the TransArticles collection of a connected TransPublication object containing a transactional publication.

To alter an existing table article of an existing transactional publication

  1. Get a TransArticle object containing a table article from the TransArticles collection of a connected TransPublication object.

  2. Use the BeginAlter method to mark the beginning of the changes.

  3. Set the TransArticle object properties to reflect the changes to the table article.

  4. Use the DoAlter method to submit the changes to Microsoft SQL Server.

To alter an existing stored procedure article of an existing transactional publication

  1. Get a TransArticle object containing a stored procedure article from the TransArticles collection of a connected TransPublication object.

  2. Use the BeginAlter method to mark the beginning of the changes.

  3. Set the TransArticle object properties to reflect the changes to the stored procedure article.

  4. Use the DoAlter method to submit the changes to SQL Server.

To add a table article to a snapshot publication

  1. Create a new TransArticle object.

  2. Set the Name property to the name of the new article.

  3. Set the SourceObjectName property to the name of a table.

  4. Set the SourceObjectOwner property to the owner of the table.

  5. Add the TransArticle object to the TransArticles collection of a connected TransPublication object containing a snapshot publication.

To add a stored procedure article to a snapshot publication

  1. Create a new TransArticle object.

  2. Set the Name property to the name of the new article.

  3. Set the SourceObjectName property to the name of a stored procedure.

  4. Set the SourceObjectOwner property to the owner of the stored procedure.

  5. Set the ArticleType property to SQLDMORep_ProcExecution or SQLDMORep_SerializableProcExecution.

  6. Add the TransArticle object to the TransArticles collection of a connected TransPublication object containing a snapshot publication.

To alter an existing table article of an existing snapshot publication

  1. Get a TransArticle object containing a table article from the TransArticles collection of a connected TransPublication object containing a snapshot publication.

  2. Use the BeginAlter method to mark the beginning of the changes.

  3. Set the TransArticle object properties to reflect the changes to the table article.

  4. Use the DoAlter method to submit the changes to SQL Server.

To alter an existing stored procedure article of an existing snapshot publication

  1. Get a TransArticle object containing a stored procedure article from the TransArticles collection of a connected TransPublication object containing a snapshot publication.

  2. Use the BeginAlter method to mark the beginning of the changes.

  3. Set the TransArticle object properties to reflect the changes to the stored procedure article.

  4. Use the DoAlter method to submit the changes to SQL Server.

Voir aussi

Référence