TransSubscription Konstruktoren

Definition

Erstellt eine neue Instanz der TransSubscription-Klasse.

Überlädt

TransSubscription()

Erstellt eine neue Instanz der TransSubscription-Klasse.

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

Erstellt eine neue Instanz der TransSubscription -Klasse mit der angegebenen Veröffentlichungs-, Datenbank-, Abonnenten- und Abonnentendatenbank sowie mit der angegebenen Verbindung mit der Instanz von Microsoft SQL Server.

Hinweise

Text aktualisiert:17. Juli 2006

Die folgende Tabelle zeigt die Standardeigenschaftenwerte für eine neue Instanz von TransSubscription. Alle Eigenschaften, die in dieser Tabelle nicht explizit aufgelistet sind, werden zu einem null Wert initialisiert.

Eigenschaft Standardwert
AgentOffload false
AgentSchedule Ein Wert von 99991231 für ActiveEndDate

Ein Wert von 235959 für ActiveEndTime

Der Wert 0 für ActiveStartDate

Der Wert 0 für ActiveStartTime

Ein Wert von 1 für FrequencyInterval

Der Wert 0 für FrequencyRecurrenceFactor

Ein Wert von First für FrequencyRelativeInterval

Ein Wert von Minute für FrequencySubDay

Der Wert 5 für FrequencySubDayInterval

Ein Wert von Continuously für FrequencyType
CachePropertyChanges false
CreateSyncAgentByDefault true
EnabledForSynchronizationManager false
FullSubscription true
IsExistingObject false
LoopBackDetection true
Status Ein Wert von Inactive für SubscriptionState
SubscriberDatasourceType Ein Wert von SqlServer für SubscriberType
SubscriberSecurity Ein Wert von true für WindowsAuthentication
SubscriberType Ein Wert von ReadOnly für TransSubscriberType
SubscriptionType Ein Wert von Push für SubscriptionOption
SynchronizationAgent Eine Instanz von TransSynchronizationAgent aus der Veröffentlichung, die dem von Ihnen erstellten Abonnement zugeordnet ist.
SyncType Ein Wert von Automatic für SubscriptionSyncType

TransSubscription()

Erstellt eine neue Instanz der TransSubscription-Klasse.

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

Beispiele

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

Hinweise

Der Standardkonstruktor initialisiert die Felder zu ihren Standardwerten.

Weitere Informationen

Gilt für:

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

Erstellt eine neue Instanz der TransSubscription -Klasse mit der angegebenen Veröffentlichungs-, Datenbank-, Abonnenten- und Abonnentendatenbank sowie mit der angegebenen Verbindung mit der Instanz von 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)

Parameter

publicationName
String

Ein String-Wert, der den Namen der Transaktionsveröffentlichung oder Momentaufnahmeveröffentlichung angibt.

databaseName
String

Ein String Wert, der den Namen der Datenbank angibt, die die Veröffentlichung enthält, oder den Namen der Verteilungsdatenbank für einen Nicht-SQL Server Verleger.

subscriberName
String

Ein String Wert, der den Namen des Abonnenten angibt.

subscriptionDBName
String

Ein String Wert, der den Namen der Abonnementdatenbank angibt.

connectionContext
ServerConnection

Ein ServerConnection -Objekt, das eine Verbindung mit dem Verleger oder dem Verteiler für ein Abonnement für einen Nicht-SQL Server Verleger darstellt.

Gilt für: