TransArticle Classe

Definizione

Spazio dei nomi:: Microsoft.SqlServer.Replication

Assembly:: Microsoft.SqlServer.Rmo.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta un articolo in una pubblicazione transazionale.

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

Ereditarietà: Object

ReplicationObject

Article
TransArticle

Esempio

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

Commenti

Sicurezza dei Thread

Qualsiasi membro pubblico statico (Sharedin Microsoft Visual Basic) di questo tipo è sicuro per operazioni multithread. Non è garantito che tutti i membri dell'istanza siano thread-safe.

Costruttori

Nome	Descrizione
TransArticle()	Crea una nuova istanza della classe TransArticle.
TransArticle(String, String, String, ServerConnection)	Crea una nuova istanza della TransArticle classe, con le proprietà richieste e con la connessione specificata all'istanza di Microsoft SQL Server.

Proprietà

Nome	Descrizione
ArticleId	Ottiene il valore dell'ID dell'articolo. (Ereditato da Article)
ArticleLogTablespace	Ottiene o imposta il nome dello spazio di tabella Oracle utilizzato per memorizzare le informazioni del log di replicazione.
CachePropertyChanges	Ottiene o stabilisce se memorizzare le modifiche apportate alle proprietà di replicazione o applicarle immediatamente. (Ereditato da ReplicationObject)
CommandFormat	Ottiene o stabilisce come i cambiamenti vengono propagati per l'articolo.
ConnectionContext	Ottiene o imposta la connessione a un'istanza di Microsoft SQL Server. (Ereditato da ReplicationObject)
CreateArticleAsHeterogeneous	Ottiene o imposta un valore che indica se creare un articolo come eterogeneo. (Ereditato da Article)
CreationScript	Ottiene o imposta il nome e il percorso completo del file script Transact-SQL che viene utilizzato per creare l'oggetto destinazione presso l'abbonato. (Ereditato da Article)
DatabaseName	Ottiene o imposta il nome del database che contiene i dati e gli oggetti pubblicati nell'articolo. (Ereditato da Article)
DatatypeMappingOptions	Restituisce se la mappatura predefinita del tipo di dato dell'articolo sia usata per un non-SQL Server Publisher.
DeleteCommand	Ottiene o imposta il comando usato per replicare le cancelli.
Description	Ottiene o stabilisce una descrizione testuale dell'articolo. (Ereditato da Article)
DestinationObjectName	Ottiene o imposta l'oggetto database che è l'oggetto sorgente del database per l'articolo presso l'Abbonato. (Ereditato da Article)
DestinationObjectOwner	Ottiene o imposta il proprietario dello schema dell'oggetto database sorgente per l'articolo presso l'Abbonato. (Ereditato da Article)
FilterClause	Ottiene o imposta la clausola WHERE usata per filtrare orizzontalmente l'articolo.
FilterProcName	Ottiene o imposta la procedura memorizzata (creata con FOR REPLICATION) utilizzata per filtrare la tabella orizzontalmente.
FilterProcOwner	Ottiene o imposta l'utente del database che possiede la stored procedure utilizzata per partizionare orizzontalmente un articolo basato su tabelle.
IdentityRangeManagementOption	Ottiene o imposta le opzioni di gestione dell'intervallo di identità per l'articolo. (Ereditato da Article)
IdentityRangeThreshold	Ottiene o imposta il valore al quale un nuovo intervallo di valori di colonne identità viene assegnato a un Publisher o a un Abbonato. (Ereditato da Article)
InsertCommand	Ottiene o imposta il comando usato per replicare gli inserti.
IsExistingObject	Ottiene se l'oggetto esiste o meno sul server. (Ereditato da ReplicationObject)
Name	Prende o imposta il nome dell'articolo. (Ereditato da Article)
PreCreationMethod	Ottiene o imposta l'azione da compiere quando l'oggetto pubblicato esiste già nel database in abbonamento. (Ereditato da Article)
PublicationName	Ottiene o imposta il nome della pubblicazione a cui appartiene l'articolo. (Ereditato da Article)
PublisherIdentityRangeSize	Ottiene o imposta l'intervallo di valori identità assegnati alle colonne della tabella presso il Publisher. (Ereditato da Article)
PublisherName	Ottiene o stabilisce il nome del non-SQL Server Publisher che pubblica l'articolo.
SchemaOption	Ottiene o imposta le opzioni di creazione dello schema per un articolo. (Ereditato da Article)
SnapshotObjectName	Ottiene o imposta l'oggetto database che fornisce l'istantanea iniziale dei dati per l'articolo.
SnapshotObjectOwner	Ottiene o imposta il proprietario dell'oggetto database che fornisce l'istantanea iniziale dei dati per l'articolo.
SourceObjectName	Ottiene o imposta il nome dell'oggetto database che viene pubblicato. (Ereditato da Article)
SourceObjectOwner	Ottiene o imposta il proprietario dell'oggetto del database che viene pubblicato. (Ereditato da Article)
SqlServerName	Ottiene il nome dell'istanza di Microsoft SQL Server a cui è collegato questo oggetto. (Ereditato da ReplicationObject)
SubscriberIdentityRangeSize	Ottiene o imposta il numero massimo di nuove righe che possono essere inserite in una colonna identità in una tabella presso un Abbonato prima che debba essere assegnato un altro intervallo di identità. (Ereditato da Article)
Type	Ottiene o definisce il tipo di articolo. (Ereditato da Article)
UpdateCommand	Riceve o imposta il comando usato per replicare gli aggiornamenti.
UserData	Ottiene o imposta una proprietà oggetto che permette agli utenti di allegare i propri dati all'oggetto. (Ereditato da ReplicationObject)
VerticalPartition	Ottiene un valore che indica se tutte le colonne sono pubblicate in un articolo di tabella. (Ereditato da Article)

Metodi

Nome	Descrizione
AddReplicatedColumns(Array)	Include colonne in un articolo di tabella con partizione verticale.
CheckValidCreation()	Controlla la validità della creazione dell'articolo. (Ereditato da Article)
CheckValidDefinition(Boolean)	Indica se la definizione è valida. (Ereditato da Article)
CommitPropertyChanges()	Invia tutte le istruzioni di modifica delle proprietà nella cache all'istanza di Microsoft SQL Server. (Ereditato da ReplicationObject)
Create()	Crea un nuovo articolo sull'istanza attualmente connessa di SQL Server basandosi sulle proprietà attuali dell'oggetto TransArticle o dell'oggettoMergeArticle. (Ereditato da Article)
Decouple()	Disaccoppia l'oggetto di replica di riferimento dal server. (Ereditato da ReplicationObject)
EnumHeterogeneousColumns()	Restituisce informazioni sulla colonna di un articolo di tabella pubblicato da un non-SQL Server Publisher.
GetChangeCommand(StringBuilder, String, String)	Restituisce il comando change dalla replicazione. (Ereditato da ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)	Restituisce il comando create dalla replicazione. (Ereditato da ReplicationObject)
GetDropCommand(StringBuilder, Boolean)	Restituisce il comando drop dalla replicazione. (Ereditato da ReplicationObject)
InternalRefresh(Boolean)	Avvia un aggiornamento interno dalla replicazione. (Ereditato da ReplicationObject)
ListReplicatedColumns()	Restituisce le colonne pubblicate in un articolo di tabella.
Load()	Carica le proprietà di un oggetto esistente dal server. (Ereditato da ReplicationObject)
LoadProperties()	Carica le proprietà di un oggetto esistente dal server. (Ereditato da ReplicationObject)
Refresh()	Ricarica le proprietà dell'oggetto. (Ereditato da ReplicationObject)
Remove()	Rimuove un articolo esistente sull'istanza attualmente collegata di SQL Server in base alle proprietà attuali dell'oggetto TransArticle o dell'oggettoMergeArticle. (Ereditato da Article)
RemoveReplicatedColumns(Array)	Esclude le colonne da un articolo di tabella partizionato verticalmente.
Script(ScriptOptions)	Genera uno script Transact-SQL che può essere eseguito per creare o eliminare l'oggetto TransArticle o l'oggetto MergeArticle sul server. (Ereditato da Article)
ScriptChangeColumnDestinationDataType(String, String, Int64, Int32, Int64, ScriptOptions)	Restituisce uno script Transact-SQL usato per modificare la mappatura del tipo di dato della colonna per un non-SQL Server Publisher.
SetColumnDestinationDataType(String, String, Int64, Int32, Int64)	Imposta la mappatura del tipo di dato della colonna per una non-SQL Server Publisher.

Si applica a

Vedi anche

Mappatura dei tipi di dati per Oracle Publishers)