TransArticle Classe

Référence

Définition

Espace de noms:: Microsoft.SqlServer.Replication

Assembly:: Microsoft.SqlServer.Rmo.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

Cohérence de thread

Tous les membres statiques publics (Shared dans Microsoft Visual Basic) de ce type sont sécurisés pour les opérations multithread. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.

Constructeurs

TransArticle()	Crée une instance de la classe TransArticle.
TransArticle(String, String, String, ServerConnection)	Crée une 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

ArticleId	Obtient la valeur d'ID 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 des modifications effectuées sur les 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 modifications sont propagées pour l'article.
ConnectionContext	Obtient ou définit la connexion à une instance de Microsoft SQL Server. (Hérité de ReplicationObject)
CreateArticleAsHeterogeneous	Obtient ou définit une valeur qui indique s'il faut créer un article hétérogène. (Hérité de Article)
CreationScript	Obtient ou définit le nom et le chemin d’accès complet du fichier de script Transact-SQL utilisé pour créer l’objet de destination sur l’Abonné. (Hérité de Article)
DatabaseName	Obtient ou définit le nom de la base de données qui contient les données et les objets publiés dans l'article. (Hérité de Article)
DatatypeMappingOptions	Retourne une valeur indiquant si le mappage du type de données de l'article par défaut est utilisé pour un serveur de publication non-SQL Server.
DeleteCommand	Obtient ou définit la commande utilisée pour répliquer des 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 de base de données source pour l'article sur l'Abonné. (Hérité de Article)
DestinationObjectOwner	Obtient ou définit le propriétaire du schéma de l'objet de base de données source pour 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 base de données propriétaire de la procédure stockée utilisée pour partitionner horizontalement un article basé sur une table.
IdentityRangeManagementOption	Obtient ou définit les options de gestion des plages d'identité pour l'article. (Hérité de Article)
IdentityRangeThreshold	Obtient ou définit la valeur à laquelle une nouvelle plage de valeurs de colonne d'identité est affectée à un serveur de publication ou à un Abonné. (Hérité de Article)
InsertCommand	Obtient ou définit la commande utilisée pour répliquer des insertions.
IsExistingObject	Détermine si l'objet existe ou non sur le serveur. (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 à entreprendre lorsque l'objet publié existe déjà dans la base de données de l'abonnement. (Hérité de Article)
PublicationName	Obtient ou définit le nom de la publication à laquelle l'article appartient. (Hérité de Article)
PublisherIdentityRangeSize	Obtient ou définit la plage de valeurs d’identité affectées aux colonnes de table sur le serveur de publication. (Hérité de Article)
PublisherName	Obtient ou définit le nom du serveur de publication non-SQL Server qui publie l'article.
SchemaOption	Obtient ou définit les options de création du 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é des données initial pour l'article.
SnapshotObjectOwner	Obtient ou définit le propriétaire de la base de données qui fournit l'instantané des données initial pour l'article.
SourceObjectName	Obtient ou définit le nom de l'objet de base de données publié. (Hérité de Article)
SourceObjectOwner	Obtient ou définit le propriétaire de l'objet de base de données 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 qui peuvent être insérées dans une colonne d'identité dans une table sur un Abonné avant qu'une autre plage d'identité ne doive être allouée. (Hérité de Article)
Type	Obtient ou définit le type de l'article. (Hérité de Article)
UpdateCommand	Obtient ou définit la commande utilisée pour répliquer des mises à jour.
UserData	Obtient ou définit une propriété d'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 table. (Hérité de Article)

Méthodes

AddReplicatedColumns(Array)	Inclut des colonnes dans un article de table partitionnée verticalement.
CheckValidCreation()	Vérifie la création de l'article valide. (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 article sur l’instance actuellement connectée de SQL Server en fonction des propriétés actuelles de l’objet TransArticle ou de l’objet MergeArticle . (Hérité de Article)
Decouple()	Dissocie l'objet de réplication référencé du serveur. (Hérité de ReplicationObject)
EnumHeterogeneousColumns()	Retourne les informations de colonne pour un article de table publié par un serveur de publication non-SQL Server.
GetChangeCommand(StringBuilder, String, String)	Retourne la commande de modification de la réplication. (Hérité de ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)	Retourne la commande de création de la réplication. (Hérité de ReplicationObject)
GetDropCommand(StringBuilder, Boolean)	Retourne la commande de suppression de la réplication. (Hérité de ReplicationObject)
InternalRefresh(Boolean)	Initialise une actualisation interne de la réplication. (Hérité de ReplicationObject)
ListReplicatedColumns()	Retourne les colonnes publiées dans un article de table.
Load()	Charge les propriétés d'un objet existant à partir du serveur. (Hérité de ReplicationObject)
LoadProperties()	Charge les propriétés d'un objet existant à partir du 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’objet MergeArticle . (Hérité de Article)
RemoveReplicatedColumns(Array)	Exclut des colonnes d'un article de table partitionnée verticalement.
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 le mappage de type de données de colonne pour un serveur de publication non SQL Server.
SetColumnDestinationDataType(String, String, Int64, Int32, Int64)	Définit le mappage du type de données de colonne pour un serveur de publication non-SQL Server.

S’applique à

Voir aussi

Mappage des types de données pour les serveurs de publication Oracle)