Partager via


TransSubscription Constructeurs

Définition

Crée une instance de la classe TransSubscription.

Surcharges

TransSubscription()

Crée une instance de la classe TransSubscription.

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

Crée une instance de la TransSubscription classe avec la publication, la base de données, l’abonné et la base de données d’abonné spécifiée, ainsi qu’avec la connexion spécifiée à l’instance de Microsoft SQL Server.

Remarques

Texte mis à jour :17 juillet 2006

Le tableau suivant montre les valeurs de propriété par défaut d’une nouvelle instance de TransSubscription. Toutes les propriétés qui ne sont pas explicitement énumérées dans cette table sont initialisées en une null valeur.

Propriété Valeur par défaut
AgentOffload false
AgentSchedule Valeur de 99991231 pour ActiveEndDate

Valeur de 235959 pour ActiveEndTime

Valeur 0 pour ActiveStartDate

Valeur 0 pour ActiveStartTime

Valeur 1 pour FrequencyInterval

Valeur 0 pour FrequencyRecurrenceFactor

Valeur de First for FrequencyRelativeInterval

Valeur de Minute for FrequencySubDay

Valeur 5 pour FrequencySubDayInterval

Valeur de Continuously for FrequencyType
CachePropertyChanges false
CreateSyncAgentByDefault true
EnabledForSynchronizationManager false
FullSubscription true
IsExistingObject false
LoopBackDetection true
Status Valeur de Inactive for SubscriptionState
SubscriberDatasourceType Valeur de SqlServer for SubscriberType
SubscriberSecurity Valeur de true for WindowsAuthentication
SubscriberType Valeur de ReadOnly for TransSubscriberType
SubscriptionType Valeur de Push for SubscriptionOption
SynchronizationAgent Instance de TransSynchronizationAgent de la composition associée à l’abonnement que vous créez.
SyncType Valeur de Automatic for SubscriptionSyncType

TransSubscription()

Crée une instance de la classe TransSubscription.

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

Exemples

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

Remarques

Le constructeur par défaut rétablit les valeurs par défaut de tous les champs.

Voir aussi

S’applique à

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

Crée une instance de la TransSubscription classe avec la publication, la base de données, l’abonné et la base de données d’abonné spécifiée, ainsi qu’avec la connexion spécifiée à l’instance 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)

Paramètres

publicationName
String

Valeur String qui spécifie le nom de la publication transactionnelle ou instantanée.

databaseName
String

Valeur String qui spécifie le nom de la base de données qui contient la publication ou le nom de la base de données de distribution pour un serveur de publication non SQL Server.

subscriberName
String

Valeur String qui spécifie le nom de l’Abonné.

subscriptionDBName
String

Valeur String qui spécifie le nom de la base de données d’abonnement.

connectionContext
ServerConnection

Objet ServerConnection qui représente une connexion au serveur de publication ou au serveur de distribution pour un abonnement à un serveur de publication non SQL Server.

S’applique à