言語

TransSubscription コンストラクター

定義

TransSubscription クラスの新しいインスタンスを作成します。

オーバーロード

名前 説明
TransSubscription()

TransSubscription クラスの新しいインスタンスを作成します。

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

指定された公開、データベース、サブスクライバー、サブスクライバーデータベース、そしてMicrosoft SQL Serverインスタンスへの指定された接続を持つ新しいインスタンスTransSubscriptionクラスを作成します。

注釈

更新テキスト: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)

指定された公開、データベース、サブスクライバー、サブスクライバーデータベース、そしてMicrosoft SQL Serverインスタンスへの指定された接続を持つ新しいインスタンスTransSubscriptionクラスを作成します。

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

出版物を含むデータベース名、または非SQL Server Publisherの配布データベース名を指定するStringの値。

subscriberName
String

加入者の名前を指定する String の価値です。

subscriptionDBName
String

サブスクリプションデータベースの名前を指定する String 値です。

connectionContext
ServerConnection

非SQL Server Publisherへのサブスクリプションに対してPublisherまたはディストリビューターへの接続を表すServerConnectionオブジェクト。

適用対象