TransArticle Klasse

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 transaktionalen Publikation 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) Mitglieder dieses Typs sind für Multithread-Operationen sicher. Instanzenmitglieder sind nicht garantiert threadsicher.

Konstruktoren

Name	Beschreibung
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 der angegebenen Verbindung zur Instanz von Microsoft SQL Server.

Eigenschaften

Name	Beschreibung
ArticleId	Erhält den Artikel-ID-Wert. (Geerbt von Article)
ArticleLogTablespace	Erhält oder setzt den Namen des Oracle-Tabellenraums, der zur Speicherung von Replikationsloginformationen verwendet wird.
CachePropertyChanges	Es gibt oder setzt, ob Änderungen an den Replikationseigenschaften zwischengespeichert oder sofort angewendet werden. (Geerbt von ReplicationObject)
CommandFormat	Erhält oder legt fest, wie Änderungen für den Artikel verbreitet werden.
ConnectionContext	Erhält oder setzt die Verbindung zu einer Instanz von Microsoft SQL Server. (Geerbt von ReplicationObject)
CreateArticleAsHeterogeneous	Erhält oder setzt einen Wert, der angibt, ob ein Artikel als heterogen erstellt werden soll. (Geerbt von Article)
CreationScript	Erhält oder setzt den Namen und den vollständigen Pfad der Transact-SQL Skriptdatei, die zur Erstellung des Zielobjekts beim Subscriber verwendet wird. (Geerbt von Article)
DatabaseName	Erhält oder setzt den Namen der Datenbank, die die Daten und die im Artikel veröffentlichten Objekte enthält. (Geerbt von Article)
DatatypeMappingOptions	Gibt zurück, ob das Standard-Artikeldatentyp-Mapping für eine Nicht-SQL Server Publisher verwendet wird.
DeleteCommand	Erhält oder setzt den Befehl, der zur Replikation von Löschungen verwendet wird.
Description	Erhält oder setzt eine textuelle Beschreibung des Artikels ein. (Geerbt von Article)
DestinationObjectName	Erhält oder setzt das Datenbankobjekt, das das Quelldatenbankobjekt für den Artikel ist, beim Subscriber. (Geerbt von Article)
DestinationObjectOwner	Erhält oder setzt den Schemabesitzer des Quelldatenbankobjekts für den Artikel beim Subscriber. (Geerbt von Article)
FilterClause	Erhält oder setzt die WHERE-Klausel , die zum horizontalen Filtern des Artikels verwendet wird.
FilterProcName	Erhält oder setzt die gespeicherte Prozedur (erstellt mit FOR REPLICATION), die zur horizontalen Filterung der Tabelle verwendet wird.
FilterProcOwner	Erhält oder setzt den Datenbankbenutzer, dem das gespeicherte Verfahren gehört, das zur horizontalen Partitionierung eines tabellenbasierten Artikels verwendet wird.
IdentityRangeManagementOption	Erhält oder setzt die Optionen zur Verwaltung des Identitätsbereichs für den Artikel. (Geerbt von Article)
IdentityRangeThreshold	Erhält oder setzt den Wert, bei dem ein neuer Bereich von Identitätsspaltenwerten einem Publisher oder einem Abonnenten zugewiesen wird. (Geerbt von Article)
InsertCommand	Erhält oder setzt den Befehl, mit dem Einsätze repliziert werden.
IsExistingObject	Es bekommt, ob das Objekt auf dem Server existiert oder nicht. (Geerbt von ReplicationObject)
Name	Erhält oder setzt den Namen des Artikels. (Geerbt von Article)
PreCreationMethod	Erhält oder setzt die Aktion, wenn das veröffentlichte Objekt bereits in der Abonnementdatenbank existiert. (Geerbt von Article)
PublicationName	Erhält oder setzt den Namen der Publikation, zu der der Artikel gehört. (Geerbt von Article)
PublisherIdentityRangeSize	Erhält oder setzt den Bereich der Identitätswerte, die den Tabellenspalten im Publisher zugewiesen werden. (Geerbt von Article)
PublisherName	Erhält oder setzt den Namen des Nicht-SQL Server Publisher, der den Artikel veröffentlicht.
SchemaOption	Erhält oder setzt die Schema-Erstellungsoptionen für einen Artikel. (Geerbt von Article)
SnapshotObjectName	Erhält oder setzt das Datenbankobjekt, das den initialen Datensnapshot für den Artikel bereitstellt.
SnapshotObjectOwner	Erhält oder setzt den Besitzer des Datenbankobjekts, das das anfängliche Datensnapshot für den Artikel bereitstellt.
SourceObjectName	Erhält oder setzt den Namen des veröffentlichten Datenbankobjekts. (Geerbt von Article)
SourceObjectOwner	Erhält oder setzt den Besitzer des veröffentlichten Datenbankobjekts. (Geerbt von Article)
SqlServerName	Erhält den Namen der Microsoft SQL Server-Instanz, mit der dieses Objekt verbunden ist. (Geerbt von ReplicationObject)
SubscriberIdentityRangeSize	Erhält oder legt die maximale Anzahl neuer Zeilen fest, die in eine Identitätsspalte in einer Tabelle bei einem Abonnenten eingefügt werden können, bevor ein anderer Identitätsbereich zugewiesen werden muss. (Geerbt von Article)
Type	Erhält oder setzt die Art des Artikels. (Geerbt von Article)
UpdateCommand	Erhält oder setzt den Befehl, mit dem Updates repliziert werden.
UserData	Erhält oder setzt eine Objekt-Eigenschaft, die es Nutzern erlaubt, eigene Daten an das Objekt anzuhängen. (Geerbt von ReplicationObject)
VerticalPartition	Erhält einen Wert, der angibt, ob alle Spalten in einem Tabellenartikel veröffentlicht sind. (Geerbt von Article)

Methoden

Name	Beschreibung
AddReplicatedColumns(Array)	Enthält Spalten in einem vertikal aufgeteilten Tabellenartikel.
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 Property-Change-Anweisungen an die Instanz von Microsoft SQL Server. (Geerbt von ReplicationObject)
Create()	Erstellt einen neuen Artikel über die aktuell verbundene Instanz von SQL Server basierend auf den aktuellen Eigenschaften des TransArticle Objekts oder des MergeArticle Objekts. (Geerbt von Article)
Decouple()	Entkoppelt das referenzierte Replikationsobjekt vom Server. (Geerbt von ReplicationObject)
EnumHeterogeneousColumns()	Liefert Spalteninformationen für einen Tabellenartikel, der von einem Nicht-SQL Server Publisher veröffentlicht wurde.
GetChangeCommand(StringBuilder, String, String)	Gibt den Änderungsbefehl aus der Replikation zurück. (Geerbt von ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)	Gibt den Create-Befehl aus der Replikation zurück. (Geerbt von ReplicationObject)
GetDropCommand(StringBuilder, Boolean)	Gibt den Drop-Befehl aus der Replikation zurück. (Geerbt von ReplicationObject)
InternalRefresh(Boolean)	Führt eine interne Aktualisierung aus der Replikation ein. (Geerbt von ReplicationObject)
ListReplicatedColumns()	Gibt die veröffentlichten Spalten in einem Tabellenartikel zurück.
Load()	Lädt die Eigenschaften eines bestehenden Objekts vom Server. (Geerbt von ReplicationObject)
LoadProperties()	Lädt die Eigenschaften eines bestehenden Objekts vom Server. (Geerbt von ReplicationObject)
Refresh()	Lädt die Eigenschaften des Objekts neu. (Geerbt von ReplicationObject)
Remove()	Entfernt einen bestehenden Artikel auf der aktuell verbundenen Instanz von SQL Server basierend auf den aktuellen Eigenschaften des TransArticle Objekts oder des MergeArticle Objekts. (Geerbt von Article)
RemoveReplicatedColumns(Array)	Schließt Spalten aus einem vertikal aufgeteilten Tabellenartikel aus.
Script(ScriptOptions)	Erzeugt 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 zur Änderung der Spaltendatentypzuordnung für eine Nicht-SQL Server Publisher verwendet wird.
SetColumnDestinationDataType(String, String, Int64, Int32, Int64)	Setzt das Spaltendatentyp-Mapping für ein Nicht-SQL Server Publisher.

Gilt für:

Weitere Informationen

Datentypabordnung für Oracle-Publisher)