TransArticle Klasse

Referenz

Definition

Namespace:: Microsoft.SqlServer.Replication

Assembly:: Microsoft.SqlServer.Rmo.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt einen Artikel in einer Transaktionsveröffentlichung dar.

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

Vererbung: Object

ReplicationObject

Article
TransArticle

Beispiele

// 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

Hinweise

Threadsicherheit

Alle öffentlichen statischen (Shared in Microsoft Visual Basic) Member dieses Typs sind für Multithreadvorgänge sicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Konstruktoren

TransArticle()	Erstellt eine neue Instanz der TransArticle-Klasse.
TransArticle(String, String, String, ServerConnection)	Erstellt eine neue Instanz der TransArticle -Klasse mit den erforderlichen Eigenschaften und mit der angegebenen Verbindung mit der Instanz von Microsoft SQL Server.

Eigenschaften

ArticleId	Ruft den ID-Wert des Artikels ab. (Geerbt von Article)
ArticleLogTablespace	Ruft den Namen des Oracle-Tabellenbereichs ab, der verwendet wurde, um Replikationsprotokollinformationen zu speichern, oder legt ihn fest.
CachePropertyChanges	Ruft ab oder legt fest, ob Änderungen an den Replikationseigenschaften zwischengespeichert oder sofort angewendet werden sollen. (Geerbt von ReplicationObject)
CommandFormat	Ruft ab oder legt fest, wie Änderungen für den Artikel weitergegeben werden.
ConnectionContext	Ruft die Verbindung mit einer Instanz von Microsoft SQL Server ab oder legt sie fest. (Geerbt von ReplicationObject)
CreateArticleAsHeterogeneous	Ruft einen Wert ab, der angibt, ob ein Artikel als heterogen erstellt werden soll, oder legt ihn fest. (Geerbt von Article)
CreationScript	Ruft den Namen und den vollständigen Pfad der Transact-SQL-Skriptdatei ab, die zum Erstellen des Zielobjekts beim Abonnenten verwendet wird, oder legt diesen fest. (Geerbt von Article)
DatabaseName	Ruft den Namen der Datenbank ab, die die Daten und Objekte enthält, die im Artikel veröffentlicht werden, oder legt ihn fest. (Geerbt von Article)
DatatypeMappingOptions	Gibt an, ob die Standardtypzuordnung von Artikeldaten für einen Nicht-SQL Server-Verleger verwendet wird.
DeleteCommand	Ruft den Befehl ab, mit dem Löschungen repliziert werden, oder legt ihn fest.
Description	Ruft eine Textbeschreibung des Artikels ab oder legt sie fest. (Geerbt von Article)
DestinationObjectName	Ruft das Datenbankobjekt ab, das das Quelldatenbankobjekt für den Artikel auf dem Abonnenten ist, oder legt es fest. (Geerbt von Article)
DestinationObjectOwner	Ruft den Schemabesitzer des Quelldatenbankobjekts für den Artikel auf dem Abonnenten ab oder legt ihn fest. (Geerbt von Article)
FilterClause	Ruft die WHERE-Klausel ab, die zum horizontalen Filtern des Artikels verwendet wird, oder legt sie fest.
FilterProcName	Ruft die gespeicherte Prozedur (erstellt mit FOR REPLICATION) ab, mit der die Tabelle horizontal gefiltert wird, oder legt sie fest.
FilterProcOwner	Ruft den Datenbankbenutzer fest, der Besitzer der gespeicherten Prozedur ist, mit der ein tabellenbasierter Artikel partitioniert wird, oder legt ihn fest.
IdentityRangeManagementOption	Ruft die Optionen zur Identitätsbereichsverwaltung für den Artikel ab oder legt sie fest. (Geerbt von Article)
IdentityRangeThreshold	Ruft den Wert ab, bei dem einem Verleger oder einem Abonnenten ein neuer Bereich von Identitätsspaltenwerten zugewiesen wird, oder legt ihn fest. (Geerbt von Article)
InsertCommand	Ruft den Befehl ab, mit dem Einfügungen repliziert werden, oder legt ihn fest.
IsExistingObject	Ruft ab, ob das Objekt auf dem Server vorhanden ist. (Geerbt von ReplicationObject)
Name	Ruft den Namen des Artikels ab oder legt ihn fest. (Geerbt von Article)
PreCreationMethod	Ruft die Aktion ab, die ausgeführt werden soll, wenn das veröffentlichte Objekt bereits in der Abonnementdatenbank vorhanden ist, oder legt sie fest. (Geerbt von Article)
PublicationName	Ruft den Namen der Veröffentlichung ab, zu der der Artikel gehört, oder legt ihn fest. (Geerbt von Article)
PublisherIdentityRangeSize	Ruft den Bereich der Identitätswerte ab, die Tabellenspalten auf dem Verleger zugewiesen sind, oder legt diesen fest. (Geerbt von Article)
PublisherName	Ruft den Namen des Nicht-SQL Server-Verlegers ab, der den Artikel veröffentlicht, oder legt ihn fest.
SchemaOption	Ruft die Schemaerstellungsoptionen für einen Artikel ab oder legt sie fest. (Geerbt von Article)
SnapshotObjectName	Ruft das Datenbankobjekt ab, das die ursprüngliche Datenmomentaufnahme für den Artikel bereitstellt, oder legt es fest.
SnapshotObjectOwner	Ruft den Besitzer des Datenbankobjekts ab, das die ursprüngliche Datenmomentaufnahme für den Artikel bereitstellt, oder legt ihn fest.
SourceObjectName	Ruft den Namen des Datenbankobjekts ab, das veröffentlicht wird, oder legt ihn fest. (Geerbt von Article)
SourceObjectOwner	Ruft den Besitzer des Datenbankobjekts ab, das veröffentlicht wird, oder legt ihn fest. (Geerbt von Article)
SqlServerName	Ruft den Namen der Microsoft SQL Server-Instanz ab, mit der dieses Objekt verbunden ist. (Geerbt von ReplicationObject)
SubscriberIdentityRangeSize	Ruft die maximale Anzahl von neuen Zeilen ab, die auf einem Abonnenten in eine Identitätsspalte in einer Tabelle eingefügt werden können, bevor ein anderer Identitätsbereich zugeordnet werden muss, oder legt sie fest. (Geerbt von Article)
Type	Ruft den Artikeltyp ab oder legt ihn fest. (Geerbt von Article)
UpdateCommand	Ruft den Befehl ab, mit dem Updates repliziert werden, oder legt ihn fest.
UserData	Ruft eine Objekteigenschaft ab, die es Benutzern ermöglicht, ihre eigenen Daten an das Objekt anzufügen, oder legt sie fest. (Geerbt von ReplicationObject)
VerticalPartition	Ruft einen Wert ab, der angibt, ob alle Spalten in einem Tabellenartikel veröffentlicht werden. (Geerbt von Article)

Methoden

AddReplicatedColumns(Array)	Schließt Spalten einem vertikal partitionierten Tabellenartikel hinzu.
CheckValidCreation()	Überprüft die gültige Artikelerstellung. (Geerbt von Article)
CheckValidDefinition(Boolean)	Gibt an, ob die Definition gültig ist. (Geerbt von Article)
CommitPropertyChanges()	Sendet alle zwischengespeicherten Eigenschaftsänderungsanweisungen an die Instanz von Microsoft SQL Server. (Geerbt von ReplicationObject)
Create()	Erstellt einen neuen Artikel für die aktuell verbundene Instanz von SQL Server basierend auf den aktuellen Eigenschaften des TransArticle -Objekts oder -MergeArticleObjekts. (Geerbt von Article)
Decouple()	Entkoppelt das Replikationsobjekt, auf das verwiesen wird, vom Server. (Geerbt von ReplicationObject)
EnumHeterogeneousColumns()	Gibt Spalteninformationen für einen von einem Nicht-SQL Server-Verleger veröffentlichten Tabellenartikel zurück.
GetChangeCommand(StringBuilder, String, String)	Gibt den Änderungsbefehl von der Replikation zurück. (Geerbt von ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)	Gibt den Erstellungsbefehl von der Replikation zurück. (Geerbt von ReplicationObject)
GetDropCommand(StringBuilder, Boolean)	Gibt den Löschbefehl von der Replikation zurück. (Geerbt von ReplicationObject)
InternalRefresh(Boolean)	Initiiert eine interne Aktualisierung von der Replikation. (Geerbt von ReplicationObject)
ListReplicatedColumns()	Gibt die veröffentlichten Spalten in einem Tabellenartikel zurück.
Load()	Lädt die Eigenschaften eines vorhandenen Objekts vom Server. (Geerbt von ReplicationObject)
LoadProperties()	Lädt die Eigenschaften eines vorhandenen Objekts vom Server. (Geerbt von ReplicationObject)
Refresh()	Lädt die Eigenschaften des Objekts erneut. (Geerbt von ReplicationObject)
Remove()	Entfernt einen vorhandenen Artikel für die aktuell verbundene Instanz von SQL Server basierend auf den aktuellen Eigenschaften des TransArticle -Objekts oder -MergeArticleObjekts. (Geerbt von Article)
RemoveReplicatedColumns(Array)	Schließt Spalten eines senkrecht partitionierten Tabellenartikels aus.
Script(ScriptOptions)	Generiert ein Transact-SQL-Skript, das ausgeführt werden kann, um das TransArticle Objekt oder das MergeArticle Objekt auf dem Server zu erstellen oder zu löschen. (Geerbt von Article)
ScriptChangeColumnDestinationDataType(String, String, Int64, Int32, Int64, ScriptOptions)	Gibt ein Transact-SQL-Skript zurück, das zum Ändern der Spaltendatentypzuordnung für einen Nicht-SQL Server Verleger verwendet wird.
SetColumnDestinationDataType(String, String, Int64, Int32, Int64)	Legt die Zuordnung für die Spaltendatentypen für einen Nicht-SQL Server-Verleger fest.

Gilt für:

Weitere Informationen

Datentypzuordnung für Oracle-Herausgeber)