Compartir a través de


TransSubscription Constructores

Definición

Crea una nueva instancia de la clase TransSubscription.

Sobrecargas

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.

Comentarios

Texto actualizado:17 de julio de 2006

En la tabla siguiente se muestran los valores de propiedad predeterminados para una nueva instancia de TransSubscription. Las propiedades que no se enumeran explícitamente en esta tabla se inicializan en un null valor.

Propiedad Valor predeterminado
AgentOffload false
AgentSchedule Valor de 99991231 para ActiveEndDate

Valor de 235959 para ActiveEndTime

Un valor de 0 para ActiveStartDate

Un valor de 0 para ActiveStartTime

Un valor de 1 para FrequencyInterval

Un valor de 0 para FrequencyRecurrenceFactor

Valor de First para FrequencyRelativeInterval

Valor de Minute para FrequencySubDay

Un valor de 5 para FrequencySubDayInterval

Valor de Continuously para FrequencyType
CachePropertyChanges false
CreateSyncAgentByDefault true
EnabledForSynchronizationManager false
FullSubscription true
IsExistingObject false
LoopBackDetection true
Status Valor de Inactive para SubscriptionState
SubscriberDatasourceType Valor de SqlServer para SubscriberType
SubscriberSecurity Valor de true para WindowsAuthentication
SubscriberType Valor de ReadOnly para TransSubscriberType
SubscriptionType Valor de Push para SubscriptionOption
SynchronizationAgent Instancia de de TransSynchronizationAgent la publicación asociada a la suscripción que se crea.
SyncType Valor de Automatic para SubscriptionSyncType

TransSubscription()

Crea una nueva instancia de la clase TransSubscription.

public:
 TransSubscription();
public TransSubscription ();
Public Sub New ()

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

El constructor predeterminado inicializa los campos con sus valores predeterminados.

Consulte también

Se aplica a

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.

public:
 TransSubscription(System::String ^ publicationName, System::String ^ databaseName, System::String ^ subscriberName, System::String ^ subscriptionDBName, Microsoft::SqlServer::Management::Common::ServerConnection ^ connectionContext);
public TransSubscription (string publicationName, string databaseName, string subscriberName, string subscriptionDBName, Microsoft.SqlServer.Management.Common.ServerConnection connectionContext);
new Microsoft.SqlServer.Replication.TransSubscription : string * string * string * string * Microsoft.SqlServer.Management.Common.ServerConnection -> Microsoft.SqlServer.Replication.TransSubscription
Public Sub New (publicationName As String, databaseName As String, subscriberName As String, subscriptionDBName As String, connectionContext As ServerConnection)

Parámetros

publicationName
String

Valor String que especifica el nombre de la publicación transaccional o de instantáneas.

databaseName
String

Valor String que especifica el nombre de la base de datos que contiene la publicación o el nombre de la base de datos de distribución para un publicador que no es de SQL Server.

subscriberName
String

Valor String que especifica el nombre del suscriptor.

subscriptionDBName
String

Valor String que especifica el nombre de la base de datos de suscripciones.

connectionContext
ServerConnection

Objeto ServerConnection que representa una conexión al publicador o al distribuidor de una suscripción a un publicador que no es de SQL Server.

Se aplica a