Langage

TransSubscription Constructeurs

Définition

Crée une instance de la classe TransSubscription.

Surcharges

Nom Description
TransSubscription()

Crée une instance de la classe TransSubscription.

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

Crée une nouvelle instance de la TransSubscription classe avec la publication, la base de données, la base de données Abonné et l’Abonné spécifiées, 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 pour une nouvelle instance de TransSubscription. Toutes les propriétés qui ne sont pas explicitement énumérées dans ce tableau sont initialisées en une null valeur.

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

Une valeur de 235959 pour ActiveEndTime

Une valeur de 0 pour ActiveStartDate

Une valeur de 0 pour ActiveStartTime

Une valeur de 1 pour FrequencyInterval

Une valeur de 0 pour FrequencyRecurrenceFactor

Une valeur de First pour FrequencyRelativeInterval

Une valeur de Minute pour FrequencySubDay

Une valeur de 5 pour FrequencySubDayInterval

Une valeur de Continuously pour FrequencyType
CachePropertyChanges false
CreateSyncAgentByDefault true
EnabledForSynchronizationManager false
FullSubscription true
IsExistingObject false
LoopBackDetection true
Status Une valeur de Inactive pour SubscriptionState
SubscriberDatasourceType Une valeur de SqlServer pour SubscriberType
SubscriberSecurity Une valeur de true pour WindowsAuthentication
SubscriberType Une valeur de ReadOnly pour TransSubscriberType
SubscriptionType Une valeur de Push pour SubscriptionOption
SynchronizationAgent Un exemple de TransSynchronizationAgent la publication associée à l’abonnement que vous créez.
SyncType Une valeur de Automatic pour 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 initialise tous les champs à leurs valeurs par défaut.

Voir aussi

S’applique à

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

Crée une nouvelle instance de la TransSubscription classe avec la publication, la base de données, la base de données Abonné et l’Abonné spécifiées, 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

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

databaseName
String

Une String valeur qui spécifie le nom de la base de données contenant la publication, ou le nom de la base de données de distribution pour un non-SQL Server Publisher.

subscriberName
String

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

subscriptionDBName
String

Une String valeur qui spécifie le nom de la base de données par abonnement.

connectionContext
ServerConnection

Un ServerConnection objet qui représente une connexion avec le Publisher ou avec le Distributeur pour un abonnement à une non-SQL Server Publisher.

S’applique à