TransArticle Clase

Referencia

Definición

Espacio de nombres:: Microsoft.SqlServer.Replication

Ensamblado:: Microsoft.SqlServer.Rmo.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Representa un artículo en una publicación transaccional.

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

Herencia: Object

ReplicationObject

Article
TransArticle

Ejemplos

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

Comentarios

Seguridad para subprocesos

Todos los miembros estáticos públicos (Shared en Microsoft Visual Basic) de este tipo son seguros para las operaciones multiproceso. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Constructores

TransArticle()	Crea una nueva instancia de la clase TransArticle.
TransArticle(String, String, String, ServerConnection)	Crea una nueva instancia de la TransArticle clase , con las propiedades necesarias y con la conexión especificada a la instancia de Microsoft SQL Server.

Propiedades

ArticleId	Obtiene el valor de identificador del artículo. (Heredado de Article)
ArticleLogTablespace	Obtiene o establece el nombre del espacio de tabla de Oracle utilizado para almacenar la información del registro de replicación.
CachePropertyChanges	Obtiene o establece si los cambios realizados en las propiedades de replicación se almacenan en memoria caché o se aplican inmediatamente. (Heredado de ReplicationObject)
CommandFormat	Obtiene o establece cómo se propagan los cambios del artículo.
ConnectionContext	Obtiene o establece la conexión a una instancia de Microsoft SQL Server. (Heredado de ReplicationObject)
CreateArticleAsHeterogeneous	Obtiene o establece un valor que indica si se ha de crear un artículo como heterogéneo. (Heredado de Article)
CreationScript	Obtiene o establece el nombre y la ruta de acceso completa del archivo de script de Transact-SQL que se usa para crear el objeto de destino en el suscriptor. (Heredado de Article)
DatabaseName	Obtiene o establece el nombre de la base de datos que contiene los datos y los objetos que se publican en el artículo. (Heredado de Article)
DatatypeMappingOptions	Devuelve si la asignación predeterminadas de tipo de datos del artículo se utiliza para un publicador que no es de SQL Server.
DeleteCommand	Obtiene o establece el comando que se usa para replicar las eliminaciones.
Description	Obtiene o establece una descripción textual del artículo. (Heredado de Article)
DestinationObjectName	Obtiene o establece el objeto de la base de datos que es el objeto de base de datos de origen del artículo en el suscriptor. (Heredado de Article)
DestinationObjectOwner	Obtiene o establece el propietario del esquema que es el objeto de base de datos de origen del artículo en el suscriptor. (Heredado de Article)
FilterClause	Obtiene o establece la cláusula WHERE utilizada para filtrar horizontalmente el artículo.
FilterProcName	Obtiene o establece el procedimiento almacenado (creado con FOR REPLICATION) que se usa para filtrar la tabla horizontalmente.
FilterProcOwner	Obtiene o establece el usuario de la base de datos propietario del procedimiento almacenado que se utiliza para crear particiones horizontalmente en un artículo basado en tabla.
IdentityRangeManagementOption	Obtiene o establece las opciones de administración de intervalos de identidad para el artículo. (Heredado de Article)
IdentityRangeThreshold	Obtiene o establece el valor en el cual los valores de una nueva columna de intervalo de identidad se asignan a un publicador o a un suscriptor. (Heredado de Article)
InsertCommand	Obtiene o establece el comando que se usa para replicar las inserciones.
IsExistingObject	Obtiene si el objeto existe en el servidor. (Heredado de ReplicationObject)
Name	Obtiene o establece el nombre del artículo. (Heredado de Article)
PreCreationMethod	Obtiene o establece la acción que se realiza cuando el objeto publicado ya existe en la base de datos de suscripciones. (Heredado de Article)
PublicationName	Obtiene o establece el nombre de la publicación a la que pertenece el artículo. (Heredado de Article)
PublisherIdentityRangeSize	Obtiene o establece el intervalo de valores de identidad asignados a columnas de tabla en el publicador. (Heredado de Article)
PublisherName	Obtiene o establece el nombre del publicador que no es de SQL Server que publica el artículo.
SchemaOption	Obtiene o establece las opciones de creación de esquema para un artículo. (Heredado de Article)
SnapshotObjectName	Obtiene o establece el objeto de la base de datos que proporciona la instantánea de datos inicial para el artículo.
SnapshotObjectOwner	Obtiene o establece el propietario del objeto de la base de datos que proporciona la instantánea de datos inicial para el artículo.
SourceObjectName	Obtiene o establece el nombre del objeto de la base de datos que se publicará. (Heredado de Article)
SourceObjectOwner	Obtiene o establece el propietario del objeto de la base de datos que se publicará. (Heredado de Article)
SqlServerName	Obtiene el nombre de la instancia de Microsoft SQL Server a la que está conectado este objeto. (Heredado de ReplicationObject)
SubscriberIdentityRangeSize	Obtiene o establece el número máximo de filas nuevas que pueden insertarse en una columna de identidad en una tabla de un suscriptor antes de que sea necesario asignar otro intervalo de identidad. (Heredado de Article)
Type	Obtiene o establece el tipo del artículo. (Heredado de Article)
UpdateCommand	Obtiene o establece el comando que se usa para replicar las actualizaciones.
UserData	Obtiene o establece una propiedad de un objeto que permite a los usuarios adjuntar sus propios datos al objeto. (Heredado de ReplicationObject)
VerticalPartition	Obtiene un valor que indica si todas las columnas están publicadas en un artículo de tabla. (Heredado de Article)

Métodos

AddReplicatedColumns(Array)	Incluye las columnas de un artículo de la tabla con particiones verticales.
CheckValidCreation()	Comprueba la creación de artículo válida. (Heredado de Article)
CheckValidDefinition(Boolean)	Indica si la definición es válida. (Heredado de Article)
CommitPropertyChanges()	Envía todas las instrucciones de cambio de propiedad almacenadas en caché a la instancia de Microsoft SQL Server. (Heredado de ReplicationObject)
Create()	Crea un nuevo artículo sobre la instancia conectada actualmente de SQL Server en función de las propiedades actuales del TransArticle objeto o del MergeArticle objeto . (Heredado de Article)
Decouple()	Desacopla del servidor el objeto de replicación al que se hace referencia. (Heredado de ReplicationObject)
EnumHeterogeneousColumns()	Devuelve la información de la columna para un artículo de la tabla publicado por un publicador que no es de SQL Server.
GetChangeCommand(StringBuilder, String, String)	Devuelve el comando de cambio de la replicación. (Heredado de ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)	Devuelve el comando de creación de la replicación. (Heredado de ReplicationObject)
GetDropCommand(StringBuilder, Boolean)	Devuelve el comando drop de la replicación. (Heredado de ReplicationObject)
InternalRefresh(Boolean)	Inicia una actualización interna de la replicación. (Heredado de ReplicationObject)
ListReplicatedColumns()	Devuelve las columnas publicadas en un artículo de la tabla.
Load()	Carga las propiedades de un objeto existente desde el servidor. (Heredado de ReplicationObject)
LoadProperties()	Carga las propiedades de un objeto existente desde el servidor. (Heredado de ReplicationObject)
Refresh()	Vuelve a cargar las propiedades del objeto. (Heredado de ReplicationObject)
Remove()	Quita un artículo existente en la instancia conectada actualmente de SQL Server en función de las propiedades actuales del TransArticle objeto o del MergeArticle objeto . (Heredado de Article)
RemoveReplicatedColumns(Array)	Excluye las columnas de un artículo de la tabla con particiones verticales.
Script(ScriptOptions)	Genera un script de Transact-SQL que se puede ejecutar para crear o eliminar el TransArticle objeto o el MergeArticle objeto en el servidor. (Heredado de Article)
ScriptChangeColumnDestinationDataType(String, String, Int64, Int32, Int64, ScriptOptions)	Devuelve un script de Transact-SQL que se usa para cambiar la asignación de tipos de datos de columna para un publicador que no es de SQL Server.
SetColumnDestinationDataType(String, String, Int64, Int32, Int64)	Establece la asignación del tipo de datos de columna para un publicador que no es de SQL Server.

Se aplica a

Consulte también

Asignación de tipos de datos para publicadores de Oracle)