語言

TransSubscription 建構函式

定義

建立 TransSubscription 類別的新實例。

多載

名稱 Description
TransSubscription()

建立 TransSubscription 類別的新實例。

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

建立一個新的類別實例TransSubscription,包含指定的發佈、資料庫、Subscriber 及 subscriber 資料庫,並以指定連線連接 Microsoft SQL Server 實例。

備註

更新文字:2006年7月17日

下表顯示了新實例 TransSubscription的預設屬性值。 未在本表中明確列舉的屬性會被初始化為一個 null 值。

房產 預設值
AgentOffload false
AgentSchedule 99991231 的值 ActiveEndDate

235959 的值 ActiveEndTime

值為 0,當 ActiveStartDate

值為 0,當 ActiveStartTime

值為 1 FrequencyInterval

值為 0,當 FrequencyRecurrenceFactor

對於 的 First 值 FrequencyRelativeInterval

對於 的 Minute 值 FrequencySubDay

值為 5 當 FrequencySubDayInterval

對於 的 Continuously 值 FrequencyType
CachePropertyChanges false
CreateSyncAgentByDefault true
EnabledForSynchronizationManager false
FullSubscription true
IsExistingObject false
LoopBackDetection true
Status 對於 的 Inactive 值 SubscriptionState
SubscriberDatasourceType 對於 的 SqlServer 值 SubscriberType
SubscriberSecurity 對於 的 true 值 WindowsAuthentication
SubscriberType 對於 的 ReadOnly 值 TransSubscriberType
SubscriptionType 對於 的 Push 值 SubscriptionOption
SynchronizationAgent TransSynchronizationAgent一個與你所建立訂閱相關的出版物範例。
SyncType 對於 的 Automatic 值 SubscriptionSyncType

TransSubscription()

建立 TransSubscription 類別的新實例。

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

範例

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

備註

預設建構子會將任何欄位初始化為其預設值。

另請參閱

適用於

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

建立一個新的類別實例TransSubscription,包含指定的發佈、資料庫、Subscriber 及 subscriber 資料庫,並以指定連線連接 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)

參數

publicationName
String

一個 String 指定交易或快照發表名稱的值。

databaseName
String

一個String指定包含該出版品的資料庫名稱,或非SQL Server Publisher的分發資料庫名稱的值。

subscriberName
String

一個 String 指定訂閱者姓名的值。

subscriptionDBName
String

一個 String 指定訂閱資料庫名稱的值。

connectionContext
ServerConnection

代表ServerConnection與Publisher或發行商的非 SQL Server Publisher訂閱連結的物件。

適用於