Compartilhar via


TransArticle Classe

Definição

Representa um artigo em uma publicação transacional.

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
Herança

Exemplos

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

Comentários

Acesso thread-safe

Todos os membros estáticos públicos (Shared no Microsoft Visual Basic) desse tipo são seguros para operações multithread. Não há garantia de que qualquer membro de instância seja seguro para threads.

Construtores

TransArticle()

Cria uma nova instância da classe TransArticle.

TransArticle(String, String, String, ServerConnection)

Cria uma nova instância da TransArticle classe , com as propriedades necessárias e com a conexão especificada com a instância do Microsoft SQL Server.

Propriedades

ArticleId

Obtém o valor de ID do artigo.

(Herdado de Article)
ArticleLogTablespace

Obtém ou define o nome do tablespace Oracle usado para armazenar informações de log de replicação.

CachePropertyChanges

Obtém ou define se as alterações feitas às propriedades de replicação devem ser armazenadas em cache ou aplicadas imediatamente.

(Herdado de ReplicationObject)
CommandFormat

Obtém ou define como as alterações são propagadas para o artigo.

ConnectionContext

Obtém ou define a conexão com uma instância do Microsoft SQL Server.

(Herdado de ReplicationObject)
CreateArticleAsHeterogeneous

Obtém ou define um valor que indica se é preciso criar um artigo como heterogêneo.

(Herdado de Article)
CreationScript

Obtém ou define o nome e o caminho completo do arquivo de script Transact-SQL usado para criar o objeto de destino no Assinante.

(Herdado de Article)
DatabaseName

Obtém ou define o nome do banco de dados que contém os dados e os objetos publicados no artigo.

(Herdado de Article)
DatatypeMappingOptions

Retorna se o mapeamento de tipo de dados de artigo padrão é usado para um Publicador não SQL Server.

DeleteCommand

Obtém ou define o comando usado para replicar exclusões.

Description

Obtém ou define uma descrição textual do artigo.

(Herdado de Article)
DestinationObjectName

Obtém ou define o objeto de banco de dados que é a origem do artigo no Assinante.

(Herdado de Article)
DestinationObjectOwner

Obtém ou define o proprietário do esquema de banco de dados de origem do artigo no Assinante.

(Herdado de Article)
FilterClause

Obtém ou define a cláusula WHERE usada para filtrar o artigo horizontalmente.

FilterProcName

Obtém ou define o procedimento armazenado (criado com FOR REPLICATION) usado para filtrar a tabela horizontalmente.

FilterProcOwner

Obtém ou define o usuário do banco de dados que possui o procedimento armazenado que é usado para particionar horizontalmente um artigo baseado em tabela.

IdentityRangeManagementOption

Obtém ou define as opções de gerenciamento de intervalo de identidade para o artigo.

(Herdado de Article)
IdentityRangeThreshold

Obtém ou define o valor ao qual um novo intervalo de valores de coluna de identidade é atribuído para um Publicador ou Assinante.

(Herdado de Article)
InsertCommand

Obtém ou define o comando usado para replicar inserções.

IsExistingObject

Especifica se o objeto existe no servidor ou não.

(Herdado de ReplicationObject)
Name

Obtém ou define o nome do artigo.

(Herdado de Article)
PreCreationMethod

Obtém ou define a ação a ser executada quando o objeto publicado já existe no banco de dados de assinatura.

(Herdado de Article)
PublicationName

Obtém ou define o nome da publicação à qual o artigo pertence.

(Herdado de Article)
PublisherIdentityRangeSize

Obtém ou define o intervalo de valores de identidade atribuídos às colunas da tabela no Publicador.

(Herdado de Article)
PublisherName

Obtém ou define o nome do Publicador não SQL Server que publica o artigo.

SchemaOption

Obtém ou define as opções de criação de esquema para um artigo.

(Herdado de Article)
SnapshotObjectName

Obtém ou define o objeto de banco de dados que fornece o instantâneo de dados inicial para o artigo.

SnapshotObjectOwner

Obtém ou define o proprietário do objeto de banco de dados que fornece o instantâneo de dados inicial para o artigo.

SourceObjectName

Obtém ou define o nome do objeto de banco de dados que está sendo publicado.

(Herdado de Article)
SourceObjectOwner

Obtém ou define o proprietário do objeto de banco de dados que está sendo publicado.

(Herdado de Article)
SqlServerName

Obtém o nome da instância do Microsoft SQL Server à qual esse objeto está conectado.

(Herdado de ReplicationObject)
SubscriberIdentityRangeSize

Obtém ou define o número máximo de novas linhas que podem ser inseridas em uma coluna de identidade em uma tabela em um Assinante, antes de outro intervalo de identidade ser alocado.

(Herdado de Article)
Type

Obtém ou define o tipo de artigo.

(Herdado de Article)
UpdateCommand

Obtém ou define o comando usado para replicar atualizações.

UserData

Obtém ou define uma propriedade de objeto que permite que os usuários anexem seus próprios dados ao objeto.

(Herdado de ReplicationObject)
VerticalPartition

Obtém um valor que indica se todas as colunas são publicadas em um artigo de tabela.

(Herdado de Article)

Métodos

AddReplicatedColumns(Array)

Inclui colunas em um artigo de tabela particionado verticalmente.

CheckValidCreation()

Verifica a criação do artigo válido.

(Herdado de Article)
CheckValidDefinition(Boolean)

Indica se a definição é válida.

(Herdado de Article)
CommitPropertyChanges()

Envia todas as instruções de alteração de propriedade armazenadas em cache para a instância do Microsoft SQL Server.

(Herdado de ReplicationObject)
Create()

Cria um novo artigo sobre a instância atualmente conectada do SQL Server com base nas propriedades atuais do TransArticle objeto ou do MergeArticle objeto .

(Herdado de Article)
Decouple()

Desacopla o objeto de replicação referenciado do servidor.

(Herdado de ReplicationObject)
EnumHeterogeneousColumns()

Retorna informações de coluna para um artigo de tabela publicado por um Publicador não SQL Server.

GetChangeCommand(StringBuilder, String, String)

Retorna o comando change da replicação.

(Herdado de ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)

Retorna o comando create da replicação.

(Herdado de ReplicationObject)
GetDropCommand(StringBuilder, Boolean)

Retorna o comando drop da replicação.

(Herdado de ReplicationObject)
InternalRefresh(Boolean)

Inicia uma atualização interna da replicação.

(Herdado de ReplicationObject)
ListReplicatedColumns()

Retorna as colunas publicadas em um artigo de tabela.

Load()

Carrega as propriedades de um objeto existente do servidor.

(Herdado de ReplicationObject)
LoadProperties()

Carrega as propriedades de um objeto existente do servidor.

(Herdado de ReplicationObject)
Refresh()

Recarrega as propriedades do objeto.

(Herdado de ReplicationObject)
Remove()

Remove um artigo existente sobre a instância atualmente conectada do SQL Server com base nas propriedades atuais do TransArticle objeto ou do MergeArticle objeto .

(Herdado de Article)
RemoveReplicatedColumns(Array)

Exclui colunas de um artigo de tabela particionado verticalmente.

Script(ScriptOptions)

Gera um script Transact-SQL que pode ser executado para criar ou excluir o TransArticle objeto ou o MergeArticle objeto no servidor.

(Herdado de Article)
ScriptChangeColumnDestinationDataType(String, String, Int64, Int32, Int64, ScriptOptions)

Retorna um script Transact-SQL usado para alterar o mapeamento de tipo de dados de coluna para um Publicador não SQL Server.

SetColumnDestinationDataType(String, String, Int64, Int32, Int64)

Define o mapeamento de tipo de dados de coluna para um Publicador não SQL Server.

Aplica-se a

Confira também