TransSubscription Construtores

Definição

Cria uma nova instância da classe TransSubscription.

Sobrecargas

Nome Description
TransSubscription()

Cria uma nova instância da classe TransSubscription.

TransSubscription(String, String, String, String, ServerConnection)

Cria uma nova instância da TransSubscription classe com a publicação, banco de dados, banco de dados de assinantes e assinante especificados, e com a conexão especificada para a instância do Microsoft SQL Server.

Comentários

Texto atualizado:17 de julho de 2006

A tabela a seguir mostra os valores padrão de propriedades para uma nova instância de TransSubscription. Quaisquer propriedades que não estejam explicitamente enumeradas nesta tabela são inicializadas a um null valor.

Property Valor padrão
AgentOffload false
AgentSchedule Um valor de 99991231 para ActiveEndDate

Um valor de 235959 para ActiveEndTime

Um valor de 0 para ActiveStartDate

Um valor de 0 para ActiveStartTime

Um valor de 1 para FrequencyInterval

Um valor de 0 para FrequencyRecurrenceFactor

Um valor de First para FrequencyRelativeInterval

Um valor de Minute para FrequencySubDay

Um valor de 5 para FrequencySubDayInterval

Um valor de Continuously para FrequencyType
CachePropertyChanges false
CreateSyncAgentByDefault true
EnabledForSynchronizationManager false
FullSubscription true
IsExistingObject false
LoopBackDetection true
Status Um valor de Inactive para SubscriptionState
SubscriberDatasourceType Um valor de SqlServer para SubscriberType
SubscriberSecurity Um valor de true para WindowsAuthentication
SubscriberType Um valor de ReadOnly para TransSubscriberType
SubscriptionType Um valor de Push para SubscriptionOption
SynchronizationAgent Um exemplo da TransSynchronizationAgent publicação associada à assinatura que você criou.
SyncType Um valor de Automatic para SubscriptionSyncType

TransSubscription()

Cria uma nova instância da classe TransSubscription.

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

Exemplos

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

Comentários

O construtor padrão inicializa qualquer campo para seus valores padrão.

Confira também

Aplica-se a

TransSubscription(String, String, String, String, ServerConnection)

Cria uma nova instância da TransSubscription classe com a publicação, banco de dados, banco de dados de assinantes e assinante especificados, e com a conexão especificada para a instância do 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

Um String valor que especifica o nome da publicação transacional ou snapshot.

databaseName
String

Um String valor que especifica o nome do banco de dados que contém a publicação, ou o nome do banco de dados de distribuição para um não-SQL Server Publisher.

subscriberName
String

Um valor que especifica String o nome do Assinante.

subscriptionDBName
String

Um String valor que especifica o nome do banco de dados de assinaturas.

connectionContext
ServerConnection

Um ServerConnection objeto que representa uma conexão com o Publisher ou com o Distribuidor para uma assinatura de um não-SQL Server Publisher.

Aplica-se a