TransSubscription 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 una suscripción de inserción a una publicación transaccional o de instantáneas.

public ref class TransSubscription sealed : Microsoft::SqlServer::Replication::Subscription

public sealed class TransSubscription : Microsoft.SqlServer.Replication.Subscription

type TransSubscription = class
    inherit Subscription

Public NotInheritable Class TransSubscription
Inherits Subscription

Herencia: Object

ReplicationObject

Subscription
TransSubscription

Ejemplos

           // Define the Publisher, publication, and databases.
           string publicationName = "AdvWorksProductTran";
           string publisherName = publisherInstance;
           string subscriberName = subscriberInstance;
           string subscriptionDbName = "AdventureWorks2012Replica";
           string publicationDbName = "AdventureWorks2012";

           //Create a connection to the Publisher.
           ServerConnection conn = new ServerConnection(publisherName);

           // Create the objects that we need.
           TransPublication publication;
           TransSubscription subscription;

           try
           {
               // Connect to the Publisher.
               conn.Connect();

               // Ensure that the publication exists and that 
               // it supports push subscriptions.
               publication = new TransPublication();
               publication.Name = publicationName;
               publication.DatabaseName = publicationDbName;
               publication.ConnectionContext = conn;

               if (publication.IsExistingObject)
               {
                   if ((publication.Attributes & PublicationAttributes.AllowPush) == 0)
                   {
                       publication.Attributes |= PublicationAttributes.AllowPush;
                   }

                   // Define the push subscription.
                   subscription = new TransSubscription();
                   subscription.ConnectionContext = conn;
                   subscription.SubscriberName = subscriberName;
                   subscription.PublicationName = publicationName;
                   subscription.DatabaseName = publicationDbName;
                   subscription.SubscriptionDBName = subscriptionDbName;

                   // Specify the Windows login credentials for the Distribution Agent job.
                   subscription.SynchronizationAgentProcessSecurity.Login = winLogin;
                   subscription.SynchronizationAgentProcessSecurity.Password = winPassword;

                   // By default, subscriptions to transactional publications are synchronized 
                   // continuously, but in this case we only want to synchronize on demand.
                   subscription.AgentSchedule.FrequencyType = ScheduleFrequencyType.OnDemand;

                   // Create the push subscription.
                   subscription.Create();
               }
               else
               {
                   // Do something here if the publication does not exist.
                   throw new ApplicationException(String.Format(
                       "The publication '{0}' does not exist on {1}.",
                       publicationName, publisherName));
               }
           }
           catch (Exception ex)
           {
               // Implement the appropriate error handling here.
               throw new ApplicationException(String.Format(
                   "The subscription to {0} could not be created.", publicationName), ex);
           }
           finally
           {
               conn.Disconnect();
           }

' Define the Publisher, publication, and databases.
Dim publicationName As String = "AdvWorksProductTran"
Dim publisherName As String = publisherInstance
Dim subscriberName As String = subscriberInstance
Dim subscriptionDbName As String = "AdventureWorks2012Replica"
Dim publicationDbName As String = "AdventureWorks2012"

'Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)

' Create the objects that we need.
Dim publication As TransPublication
Dim subscription As TransSubscription

Try
    ' Connect to the Publisher.
    conn.Connect()

    ' Ensure that the publication exists and that 
    ' it supports push subscriptions.
    publication = New TransPublication()
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName
    publication.ConnectionContext = conn

    If publication.IsExistingObject Then
        If (publication.Attributes And PublicationAttributes.AllowPush) = 0 Then
            publication.Attributes = publication.Attributes _
            Or PublicationAttributes.AllowPush
        End If

        ' Define the push subscription.
        subscription = New TransSubscription()
        subscription.ConnectionContext = conn
        subscription.SubscriberName = subscriberName
        subscription.PublicationName = publicationName
        subscription.DatabaseName = publicationDbName
        subscription.SubscriptionDBName = subscriptionDbName

        ' Specify the Windows login credentials for the Distribution Agent job.
        subscription.SynchronizationAgentProcessSecurity.Login = winLogin
        subscription.SynchronizationAgentProcessSecurity.Password = winPassword

        ' By default, subscriptions to transactional publications are synchronized 
        ' continuously, but in this case we only want to synchronize on demand.
        subscription.AgentSchedule.FrequencyType = ScheduleFrequencyType.OnDemand

        ' Create the push subscription.
        subscription.Create()
    Else
        ' Do something here if the publication does not exist.
        Throw New ApplicationException(String.Format( _
         "The publication '{0}' does not exist on {1}.", _
         publicationName, publisherName))
    End If

Catch ex As Exception
    ' Implement the appropriate error handling here.
    Throw New ApplicationException(String.Format( _
        "The subscription to {0} could not be created.", publicationName), ex)
Finally
    conn.Disconnect()
End Try

Comentarios

Al configurar un publicador con un distribuidor remoto, los valores proporcionados para todos los parámetros, incluidos SynchronizationAgentProcessSecurity, se envían al distribuidor como texto sin formato. Debe cifrar la conexión entre el publicador y su distribuidor remoto antes de llamar al método Create . Para obtener más información, vea sp_reinitsubscription (Transact-SQL).

Cuando la suscripción pertenece a un publicador que no es de SQL Server, la ConnectionContext propiedad se establece en el distribuidor en lugar de en Publisher, la DatabaseName propiedad se establece en la base de datos de distribución en lugar de en la base de datos de publicación y la PublisherName propiedad se establece en el nombre del publicador que no es de SQL Server.

Seguridad para subprocesos

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

TransSubscription()	Crea una nueva instancia de la clase TransSubscription.
TransSubscription(String, String, String, String, ServerConnection)	Crea una nueva instancia de la TransSubscription clase con la publicación, base de datos, suscriptor y base de datos de suscriptor especificada, y con la conexión especificada a la instancia de Microsoft SQL Server.

Propiedades

AgentJobId	Obtiene el identificador del trabajo del agente utilizado para sincronizar la suscripción. (Heredado de Subscription)
AgentOffload	Obtiene o establece si el agente de sincronización se ejecuta en un equipo distinto del equipo donde se creó el trabajo de agente. Esta propiedad ya no es compatible con distribuidores que ejecutan Microsoft SQL Server 2005 y versiones posteriores. (Heredado de Subscription)
AgentOffloadServer	Obtiene o establece el nombre del equipo remoto donde se ejecuta el agente cuando se usa la activación remota del agente. (Heredado de Subscription)
AgentSchedule	Obtiene el trabajo del agente utilizado para sincronizar la suscripción. (Heredado de Subscription)
BackupInformation	Obtiene o establece la información necesaria para inicializar una suscripción desde una copia de seguridad.
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)
ConnectionContext	Obtiene o establece la conexión a una instancia de Microsoft SQL Server. (Heredado de ReplicationObject)
CreateSyncAgentByDefault	Obtiene o establece si de forma predeterminada se crea el trabajo de agente utilizado para sincronizar la suscripción. (Heredado de Subscription)
DatabaseName	Obtiene o establece el nombre de la base de datos de publicación. (Heredado de Subscription)
DtsPackageLocation	Obtiene o establece la ubicación del paquete de Servicios de transformación de datos (DTS) de Microsoft SQL Server 2000.
DtsPackageName	Obtiene o establece el nombre del paquete de Servicios de transformación de datos (DTS) de Microsoft SQL Server 2000 que se aplica en el suscriptor.
DtsPackagePassword	Establece la contraseña usada para ejecutar el paquete de Servicios de transformación de datos (DTS) de Microsoft SQL Server 2000.
EnabledForSynchronizationManager	Especifica si la suscripción se puede sincronizar mediante el Administrador de sincronización de Microsoft Windows. (Heredado de Subscription)
FullSubscription	Obtiene un valor que indica si la suscripción está completa.
IsExistingObject	Obtiene si el objeto existe en el servidor. (Heredado de ReplicationObject)
LoopBackDetection	Obtiene o establece si el agente de distribución envía o no las transacciones originadas en el suscriptor al mismo suscriptor.
MemoryOptimized	Representa una suscripción de inserción a una publicación transaccional o de instantáneas.
Name	Obtiene el nombre asignado a una suscripción existente. (Heredado de Subscription)
PublicationName	Obtiene o establece el nombre de la publicación a la que se realiza la suscripción. (Heredado de Subscription)
PublisherName	Obtiene o establece el nombre del publicador cuando la suscripción pertenece a un publicador que no es de SQL Server.
SecureDtsPackagePassword	Establece la contraseña (como un SecureString objeto) que se usa para ejecutar el paquete de Servicios de transformación de datos (DTS) de Microsoft SQL Server 2000.
SqlServerName	Obtiene el nombre de la instancia de Microsoft SQL Server a la que está conectado este objeto. (Heredado de ReplicationObject)
Status	Obtiene el estado de la suscripción. (Heredado de Subscription)
SubscriberCatalog	Obtiene o establece el catálogo utilizado al realizar una conexión con el proveedor OLE DB para un suscriptor que no sea SQL Server.
SubscriberDatasource	Nombre del origen de datos tal y como entiende el proveedor OLE DB para un suscriptor que no sea SQL Server.
SubscriberDatasourceType	Identifica el tipo de origen de datos que es un suscriptor que no es SQL Server.
SubscriberLocation	Ubicación de la base de datos tal y como entiende el proveedor OLE DB para el suscriptor que no es de SQL Server.
SubscriberName	Obtiene o establece el nombre de la instancia de Microsoft SQL Server que es el suscriptor. (Heredado de Subscription)
SubscriberProvider	Identificador de programación único (PROGID) con el que está registrado el proveedor OLE DB para el suscriptor que no es SQL Server
SubscriberProviderString	La cadena de conexión específica del proveedor OLE DB se usa para conectarse al origen de datos para suscriptores que no son de SQL Server.
SubscriberSecurity	Obtiene el contexto de seguridad que usa para la conexión al suscriptor. (Heredado de Subscription)
SubscriberType	Obtiene o establece el comportamiento de actualización de los cambios en los datos en el suscriptor.
SubscriptionDBName	Obtiene o establece el nombre de la base de datos del suscriptor que recibe los datos replicados. (Heredado de Subscription)
SubscriptionLSN	Obtiene o establece el número de secuencia de registro de la suscripción.
SubscriptionType	Obtiene si el registro de la suscripción es para una suscripción de inserción o de extracción. (Heredado de Subscription)
SynchronizationAgent	Obtiene una instancia de la clase TransSynchronizationAgent que puede utilizarse para sincronizar la suscripción.
SynchronizationAgentName	Obtiene o establece el nombre del trabajo de agente creado para sincronizar la suscripción. (Heredado de Subscription)
SynchronizationAgentProcessSecurity	Obtiene el contexto de seguridad que se usa para especificar la cuenta de Microsoft Windows con la que se ejecuta el trabajo del agente de sincronización para sincronizar la suscripción. (Heredado de Subscription)
SyncType	Obtiene o establece la manera en la que se inicializa la suscripción. (Heredado de Subscription)
UserData	Obtiene o establece una propiedad de un objeto que permite a los usuarios adjuntar sus propios datos al objeto. (Heredado de ReplicationObject)

Métodos

CheckValidCreation()	Comprueba la creación de replicación válida. (Heredado de ReplicationObject)
CheckValidDefinition(Boolean)	Indica si la definición de suscripción es válida. (Heredado de Subscription)
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 el registro de la suscripción en el publicador. (Heredado de Subscription)
Decouple()	Desacopla del servidor el objeto de replicación al que se hace referencia. (Heredado de ReplicationObject)
DoUpdateMemoryOptimizedProperty(String)	Representa una suscripción de inserción a una publicación transaccional o de instantáneas.
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)
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)
Reinitialize()	Marca la suscripción para reinicializarla la próxima vez que se ejecute el Agente de distribución para sincronizar la suscripción.
Reinitialize(Boolean)	Reinicializa la suscripción.
Remove()	Elimina el registro de la suscripción en el publicador y quita los objetos de replicación del suscriptor para una suscripción de inserción. (Heredado de Subscription)
Script(ScriptOptions)	Devuelve un script de Transact-SQL que se puede usar para crear o eliminar la suscripción. (Heredado de Subscription)
StopSynchronizationJob()	Intenta detener un trabajo del Agente de distribución en ejecución que está sincronizando la suscripción actualmente.
SynchronizeWithJob()	Inicia el trabajo del agente para sincronizar la suscripción.

Se aplica a

Consulte también

Cómo crear una suscripción de inserción (programación con RMO)