TransArticle Classe

Riferimento

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

Thread safety

Tutti i membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono sicuri per le operazioni multithreaded. Non è invece garantita la sicurezza dei membri dell'istanza.

Costruttori

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

Proprietà

ArticleId	Ottiene il valore ID dell'articolo. (Ereditato da Article)
ArticleLogTablespace	Ottiene o imposta il nome dello spazio di tabella Oracle utilizzato per archiviare le informazioni del log delle repliche.
CachePropertyChanges	Ottiene o imposta un valore che indica se memorizzare nella cache o se applicare immediatamente le modifiche apportate alle proprietà di replica. (Ereditato da ReplicationObject)
CommandFormat	Ottiene o imposta la modalità di propagazione delle modifiche 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 deve essere creato un articolo eterogeneo. (Ereditato da Article)
CreationScript	Ottiene o imposta il nome e il percorso completo del file di script Transact-SQL usato per creare l'oggetto di destinazione nel Sottoscrittore. (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 un valore che indica se viene utilizzato il mapping predefinito dei tipi di dati dell'articolo per un server di pubblicazione non SQL Server.
DeleteCommand	Ottiene o imposta il comando utilizzato per replicare le eliminazioni.
Description	Ottiene o imposta una descrizione in formato testo dell'articolo. (Ereditato da Article)
DestinationObjectName	Ottiene o imposta l'oggetto di database che è l'oggetto di database di origine per l'articolo nel Sottoscrittore. (Ereditato da Article)
DestinationObjectOwner	Ottiene o imposta il proprietario dello schema dell'oggetto di database di origine per l'articolo nel Sottoscrittore. (Ereditato da Article)
FilterClause	Ottiene o imposta la clausola WHERE usata per filtrare l'articolo orizzontalmente.
FilterProcName	Ottiene o imposta la stored procedure (creata con FOR REPLICATION) utilizzata per filtrare la tabella in senso orizzontale.
FilterProcOwner	Ottiene o imposta l'utente del database proprietario della stored procedure utilizzata per partizionare in senso orizzontale un articolo basato su tabella.
IdentityRangeManagementOption	Ottiene o imposta le opzioni di gestione degli intervalli di valori Identity per l'articolo. (Ereditato da Article)
IdentityRangeThreshold	Ottiene o imposta il valore in corrispondenza del quale viene assegnato un nuovo intervallo di valori della colonna Identity a un server di pubblicazione o a un Sottoscrittore. (Ereditato da Article)
InsertCommand	Ottiene o imposta il comando utilizzato per replicare gli inserimenti.
IsExistingObject	Ottiene un valore che indica se l'oggetto esiste nel server. (Ereditato da ReplicationObject)
Name	Ottiene o imposta il nome dell'articolo. (Ereditato da Article)
PreCreationMethod	Ottiene o imposta l'azione da intraprendere quando l'oggetto pubblicato esiste già nel database di sottoscrizione. (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 identity assegnati alle colonne di tabella nel server di pubblicazione. (Ereditato da Article)
PublisherName	Ottiene o imposta il nome del server di pubblicazione non SQL Server che pubblica l'articolo.
SchemaOption	Ottiene o imposta le opzioni di creazione dello schema per un articolo. (Ereditato da Article)
SnapshotObjectName	Ottiene o imposta il nome dell'oggetto di database che fornisce lo snapshot di dati iniziale per l'articolo.
SnapshotObjectOwner	Ottiene o imposta il proprietario dell'oggetto di database che fornisce lo snapshot di dati iniziale per l'articolo.
SourceObjectName	Ottiene o imposta il nome dell'oggetto di database da pubblicare. (Ereditato da Article)
SourceObjectOwner	Ottiene o imposta il proprietario dell'oggetto di database da pubblicare. (Ereditato da Article)
SqlServerName	Ottiene il nome dell'istanza di Microsoft SQL Server a cui è connesso questo oggetto. (Ereditato da ReplicationObject)
SubscriberIdentityRangeSize	Ottiene o imposta il numero massimo di nuove righe che è possibile inserire in una colonna Identity di una tabella in un Sottoscrittore prima di allocare un altro intervallo di valori Identity. (Ereditato da Article)
Type	Ottiene o imposta il tipo dell'articolo. (Ereditato da Article)
UpdateCommand	Ottiene o imposta il comando utilizzato per replicare gli aggiornamenti.
UserData	Ottiene o imposta una proprietà di un oggetto che consente agli utenti di collegare i relativi dati all'oggetto in questione. (Ereditato da ReplicationObject)
VerticalPartition	Ottiene un valore che indica se tutte le colonne vengono pubblicate in un articolo di tabella. (Ereditato da Article)

Metodi

AddReplicatedColumns(Array)	Include le colonne in un articolo di tabella partizionato in senso verticale.
CheckValidCreation()	Controlla la creazione dell'articolo valido. (Ereditato da Article)
CheckValidDefinition(Boolean)	Indica se la definizione è valida. (Ereditato da Article)
CommitPropertyChanges()	Invia tutte le istruzioni di modifica della proprietà memorizzate nella cache all'istanza di Microsoft SQL Server. (Ereditato da ReplicationObject)
Create()	Crea un nuovo articolo sull'istanza attualmente connessa di SQL Server in base alle proprietà correnti dell'oggetto o dell'oggetto TransArticle MergeArticle. (Ereditato da Article)
Decouple()	Disaccoppia dal server l'oggetto di replica a cui si fa riferimento. (Ereditato da ReplicationObject)
EnumHeterogeneousColumns()	Restituisce informazioni sulle colonne per un articolo di tabella pubblicato da un server di pubblicazione non SQL Server.
GetChangeCommand(StringBuilder, String, String)	Restituisce il comando di modifica dalla replica. (Ereditato da ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)	Restituisce il comando di creazione dalla replica. (Ereditato da ReplicationObject)
GetDropCommand(StringBuilder, Boolean)	Restituisce il comando di eliminazione dalla replica. (Ereditato da ReplicationObject)
InternalRefresh(Boolean)	Avvia un aggiornamento interno dalla replica. (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 nell'istanza attualmente connessa di SQL Server in base alle proprietà correnti dell'oggetto o dell'oggetto TransArticle MergeArticle. (Ereditato da Article)
RemoveReplicatedColumns(Array)	Esclude le colonne da un articolo di tabella partizionato in senso verticale.
Script(ScriptOptions)	Genera uno script Transact-SQL che può essere eseguito per creare o eliminare l'oggetto o l'oggetto TransArticle MergeArticle nel server. (Ereditato da Article)
ScriptChangeColumnDestinationDataType(String, String, Int64, Int32, Int64, ScriptOptions)	Restituisce uno script Transact-SQL usato per modificare il mapping dei tipi di dati della colonna per un server di pubblicazione non SQL Server.
SetColumnDestinationDataType(String, String, Int64, Int32, Int64)	Imposta il mapping del tipo di dati della colonna per un server di pubblicazione non SQL Server.

Si applica a

Vedi anche

Mapping dei tipi di dati per i server di pubblicazione Oracle)