TransArticle Classe

Définition

Espace de noms:

Microsoft.SqlServer.Replication

Assembly:

Microsoft.SqlServer.Rmo.dll

Représente un article dans une publication transactionnelle.

public ref class TransArticle sealed : Microsoft::SqlServer::Replication::Article

public sealed class TransArticle : Microsoft.SqlServer.Replication.Article

type TransArticle = class
    inherit Article

Public NotInheritable Class TransArticle
Inherits Article

Héritage

Object

ReplicationObject

Article

TransArticle

Exemples

// Define the Publisher, publication, and article names.
string publisherName = publisherInstance;
string publicationName = "AdvWorksProductTran";
string publicationDbName = "AdventureWorks2012";
string articleName = "Product";
string schemaOwner = "Production";

TransArticle article;

// Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);

// Create a filtered transactional articles in the following steps:
// 1) Create the  article with a horizontal filter clause.
// 2) Add columns to or remove columns from the article.
try
{
    // Connect to the Publisher.
    conn.Connect();

    // Define a horizontally filtered, log-based table article.
    article = new TransArticle();
    article.ConnectionContext = conn;
    article.Name = articleName;
    article.DatabaseName = publicationDbName;
    article.SourceObjectName = articleName;
    article.SourceObjectOwner = schemaOwner;
    article.PublicationName = publicationName;
    article.Type = ArticleOptions.LogBased;
    article.FilterClause = "DiscontinuedDate IS NULL";

    // Ensure that we create the schema owner at the Subscriber.
    article.SchemaOption |= CreationScriptOptions.Schema;

    if (!article.IsExistingObject)
    {
        // Create the article.
        article.Create();
    }
    else
    {
        throw new ApplicationException(String.Format(
            "The article {0} already exists in publication {1}.",
            articleName, publicationName));
    }

    // Create an array of column names to remove from the article.
    String[] columns = new String[1];
    columns[0] = "DaysToManufacture";

    // Remove the column from the article.
    article.RemoveReplicatedColumns(columns);
}
catch (Exception ex)
{
    // Implement appropriate error handling here.
    throw new ApplicationException("The article could not be created.", ex);
}
finally
{
    conn.Disconnect();
}

' Define the Publisher, publication, and article names.
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksProductTran"
Dim publicationDbName As String = "AdventureWorks2012"
Dim articleName As String = "Product"
Dim schemaOwner As String = "Production"

Dim article As TransArticle

' Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)

' Create a filtered transactional articles in the following steps:
' 1) Create the  article with a horizontal filter clause.
' 2) Add columns to or remove columns from the article.
Try
    ' Connect to the Publisher.
    conn.Connect()

    ' Define a horizontally filtered, log-based table article.
    article = New TransArticle()
    article.ConnectionContext = conn
    article.Name = articleName
    article.DatabaseName = publicationDbName
    article.SourceObjectName = articleName
    article.SourceObjectOwner = schemaOwner
    article.PublicationName = publicationName
    article.Type = ArticleOptions.LogBased
    article.FilterClause = "DiscontinuedDate IS NULL"

    ' Ensure that we create the schema owner at the Subscriber.
    article.SchemaOption = article.SchemaOption Or _
    CreationScriptOptions.Schema

    If Not article.IsExistingObject Then
        ' Create the article.
        article.Create()
    Else
        Throw New ApplicationException(String.Format( _
         "The article {0} already exists in publication {1}.", _
         articleName, publicationName))
    End If

    ' Create an array of column names to remove from the article.
    Dim columns() As String = New String(0) {}
    columns(0) = "DaysToManufacture"

    ' Remove the column from the article.
    article.RemoveReplicatedColumns(columns)
Catch ex As Exception
    ' Implement appropriate error handling here.
    Throw New ApplicationException("The article could not be created.", ex)
Finally
    conn.Disconnect()
End Try

Remarques

Sécurité des threads

Tout membre statique public (Shareddans Microsoft Visual Basic) de ce type est sûr pour les opérations multithreads. Il n'y a aucune garantie que les membres d’instance soient thread-safe.

Constructeurs

Nom	Description
TransArticle()	Crée une instance de la classe TransArticle.
TransArticle(String, String, String, ServerConnection)	Crée une nouvelle instance de la TransArticle classe, avec les propriétés requises et avec la connexion spécifiée à l’instance de Microsoft SQL Server.

Propriétés

Nom	Description
ArticleId	Ça obtient la valeur d’identification de l’article. (Hérité de Article)
ArticleLogTablespace	Obtient ou définit le nom de l’espace de table Oracle utilisé pour stocker les informations du journal de réplication.
CachePropertyChanges	Obtient ou définit s’il faut mettre en cache les modifications apportées aux propriétés de réplication ou les appliquer immédiatement. (Hérité de ReplicationObject)
CommandFormat	Obtient ou définit la manière dont les changements sont propagés pour l’article.
ConnectionContext	Obtient ou définit la connexion vers une instance de Microsoft SQL Server. (Hérité de ReplicationObject)
CreateArticleAsHeterogeneous	Obtient ou fixe une valeur qui indique s’il faut créer un article comme hétérogène. (Hérité de Article)
CreationScript	Obtient ou définit le nom et le chemin complet du fichier script Transact-SQL utilisé pour créer l’objet de destination chez l’abonné. (Hérité de Article)
DatabaseName	Obtient ou définit le nom de la base de données contenant les données et les objets publiés dans l’article. (Hérité de Article)
DatatypeMappingOptions	Indique si la correspondance par défaut du type de données d’article est utilisée pour un non-SQL Server Publisher.
DeleteCommand	Obtient ou définit la commande utilisée pour répliquer les suppressions.
Description	Obtient ou définit une description textuelle de l’article. (Hérité de Article)
DestinationObjectName	Obtient ou définit l’objet de base de données qui est l’objet source de base de données de l’article à l’abonné. (Hérité de Article)
DestinationObjectOwner	Obtient ou définit le propriétaire du schéma de l’objet source de base de données de l’article sur l’Abonné. (Hérité de Article)
FilterClause	Obtient ou définit la clause WHERE utilisée pour filtrer horizontalement l’article.
FilterProcName	Obtient ou définit la procédure stockée (créée avec FOR REPLICATION) utilisée pour filtrer la table horizontalement.
FilterProcOwner	Obtient ou définit l’utilisateur de la base de données qui possède la procédure stockée utilisée pour partitionner horizontalement un article basé sur un tableau.
IdentityRangeManagementOption	Obtient ou définit les options de gestion de la plage d’identité pour l’article. (Hérité de Article)
IdentityRangeThreshold	Obtient ou définit la valeur à laquelle une nouvelle plage de valeurs de colonnes d’identité est attribuée à un Publisher ou à un Abonné. (Hérité de Article)
InsertCommand	Obtient ou définit la commande utilisée pour répliquer les inserts.
IsExistingObject	Ça détermine si l’objet existe sur le serveur ou non. (Hérité de ReplicationObject)
Name	Obtient ou définit le nom de l’article. (Hérité de Article)
PreCreationMethod	Obtient ou définit l’action à effectuer lorsque l’objet publié existe déjà dans la base de données par abonnement. (Hérité de Article)
PublicationName	Obtient ou donne le nom de la publication à laquelle l’article appartient. (Hérité de Article)
PublisherIdentityRangeSize	Obtient ou définit la plage de valeurs d’identité attribuées aux colonnes de table dans le Publisher. (Hérité de Article)
PublisherName	Obtient ou définit le nom du non-SQL Server Publisher qui publie l’article.
SchemaOption	Obtient ou définit les options de création de schéma pour un article. (Hérité de Article)
SnapshotObjectName	Obtient ou définit l’objet de base de données qui fournit l’instantané initial des données pour l’article.
SnapshotObjectOwner	Obtient ou définit le propriétaire de l’objet de base de données qui fournit l’instantané initial des données de l’article.
SourceObjectName	Obtient ou définit le nom de l’objet de base de données qui est publié. (Hérité de Article)
SourceObjectOwner	Obtient ou définit le propriétaire de l’objet de base de données qui est publié. (Hérité de Article)
SqlServerName	Obtient le nom de l’instance Microsoft SQL Server à laquelle cet objet est connecté. (Hérité de ReplicationObject)
SubscriberIdentityRangeSize	Obtient ou définit le nombre maximal de nouvelles lignes pouvant être insérées dans une colonne d’identité dans une table à un Abonné avant qu’une autre plage d’identité ne doive être allouée. (Hérité de Article)
Type	Reçoit ou définit le type d’article. (Hérité de Article)
UpdateCommand	Obtient ou définit la commande utilisée pour répliquer les mises à jour.
UserData	Obtient ou définit une propriété objet qui permet aux utilisateurs d’attacher leurs propres données à l’objet. (Hérité de ReplicationObject)
VerticalPartition	Obtient une valeur qui indique si toutes les colonnes sont publiées dans un article de tableau. (Hérité de Article)

Méthodes

Nom	Description
AddReplicatedColumns(Array)	Inclut des colonnes dans un article de tableau à partitionnement vertical.
CheckValidCreation()	Vérifie la validité de la création de l’article. (Hérité de Article)
CheckValidDefinition(Boolean)	Indique si la définition est valide. (Hérité de Article)
CommitPropertyChanges()	Envoie toutes les instructions de modification de propriété mises en cache à l’instance de Microsoft SQL Server. (Hérité de ReplicationObject)
Create()	Crée un nouvel article sur l’instance actuellement connectée de SQL Server en fonction des propriétés actuelles de l’objet TransArticle ou de l’objetMergeArticle. (Hérité de Article)
Decouple()	Découple l’objet de réplication référencé du serveur. (Hérité de ReplicationObject)
EnumHeterogeneousColumns()	Restitue les informations de colonne pour un article de tableau publié par un non-SQL Server Publisher.
GetChangeCommand(StringBuilder, String, String)	Retourne la commande de changement de la réplication. (Hérité de ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)	Retourne la commande create de la réplication. (Hérité de ReplicationObject)
GetDropCommand(StringBuilder, Boolean)	Retourne la commande drop de la réplication. (Hérité de ReplicationObject)
InternalRefresh(Boolean)	Initie un rafraîchissement interne à partir de la réplication. (Hérité de ReplicationObject)
ListReplicatedColumns()	Retourne les colonnes publiées dans un article de tableau.
Load()	Charge les propriétés d’un objet existant depuis le serveur. (Hérité de ReplicationObject)
LoadProperties()	Charge les propriétés d’un objet existant depuis le serveur. (Hérité de ReplicationObject)
Refresh()	Recharge les propriétés de l’objet. (Hérité de ReplicationObject)
Remove()	Supprime un article existant sur l’instance actuellement connectée de SQL Server en fonction des propriétés actuelles de l’objet TransArticle ou de l’objetMergeArticle. (Hérité de Article)
RemoveReplicatedColumns(Array)	Exclut les colonnes d’un article de tableau à partitionnement vertical.
Script(ScriptOptions)	Génère un script Transact-SQL qui peut être exécuté pour créer ou supprimer l’objet TransArticle ou l’objet MergeArticle sur le serveur. (Hérité de Article)
ScriptChangeColumnDestinationDataType(String, String, Int64, Int32, Int64, ScriptOptions)	Retourne un script Transact-SQL utilisé pour modifier la correspondance du type de données de la colonne pour un non-SQL Server Publisher.
SetColumnDestinationDataType(String, String, Int64, Int32, Int64)	Établit la correspondance du type de données de la colonne pour une non-SQL Server Publisher.

Voir aussi

• Cartographie des types de données pour Oracle Publishers)