TransPullSubscription コンストラクター

リファレンス

定義

名前空間:: Microsoft.SqlServer.Replication

アセンブリ:: Microsoft.SqlServer.Rmo.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

オーバーロード

TransPullSubscription()	TransPullSubscription クラスの新しいインスタンスを作成します。
TransPullSubscription(String, String, String, String, ServerConnection)	プルサブスクリプションを定義するプロパティを使用して TransPullSubscription クラスの新しいインスタンスを作成します。
TransPullSubscription(String, String, String, String, ServerConnection, Boolean)	プルサブスクリプション、およびサブスクリプションのエージェントジョブを作成するかどうかを定義するプロパティを使用して、TransPullSubscription クラスの新しいインスタンスを作成します。

注釈

更新されたテキスト:2006 年 7 月 17 日

次の表に、TransPullSubscription の新しいインスタンスに使用される既定のプロパティ値を示します。この表に明示されていないプロパティは、null 値に初期化されます。

プロパティ	既定値
AgentOffload	`false`
AgentSchedule	の99991231の値 ActiveEndDate の235959の値 ActiveEndTime ActiveStartDate の場合、サブスクリプションの作成日の値になります。の値 0 ActiveStartTime の値 0 FrequencyInterval の値 0 FrequencyRecurrenceFactor の値 0 FrequencySubDayInterval FrequencyType の場合、値 `Continuously` になります。
CachePropertyChanges	`false`
CreateSyncAgentByDefault	`false`
DistributorSecurity	WindowsAuthentication の場合、値 `true` になります。
EnabledForSynchronizationManager	`false`
IsExistingObject	`false`
SubscriberSecurity	WindowsAuthentication の場合、値 `true` になります。
SubscriberType	TransSubscriberType の場合、値 `ReadOnly` になります。
SubscriptionType	SubscriptionOption の場合、値 `Pull` になります。
SynchronizationAgent	作成したサブスクリプションに関連するパブリケーションの TransSynchronizationAgent のインスタンスになります。
Type	PublicationType の場合、値 `Transactional` になります。
UseFtp	`false`

TransPullSubscription()

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

public:
 TransPullSubscription();

public TransPullSubscription ();

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 connections to the Publisher and Subscriber.
ServerConnection subscriberConn = new ServerConnection(subscriberName);
ServerConnection publisherConn = new ServerConnection(publisherName);

// Create the objects that we need.
TransPublication publication;
TransPullSubscription subscription;

try
{
    // Connect to the Publisher and Subscriber.
    subscriberConn.Connect();
    publisherConn.Connect();

    // Ensure that the publication exists and that 
    // it supports pull subscriptions.
    publication = new TransPublication();
    publication.Name = publicationName;
    publication.DatabaseName = publicationDbName;
    publication.ConnectionContext = publisherConn;

    if (publication.IsExistingObject)
    {
        if ((publication.Attributes & PublicationAttributes.AllowPull) == 0)
        {
            publication.Attributes |= PublicationAttributes.AllowPull;
        }

        // Define the pull subscription.
        subscription = new TransPullSubscription();
        subscription.ConnectionContext = subscriberConn;
        subscription.PublisherName = publisherName;
        subscription.PublicationName = publicationName;
        subscription.PublicationDBName = publicationDbName;
        subscription.DatabaseName = subscriptionDbName;

        // Specify the Windows login credentials for the Distribution Agent job.
        subscription.SynchronizationAgentProcessSecurity.Login = winLogin;
        subscription.SynchronizationAgentProcessSecurity.Password = winPassword;

        // Make sure that the agent job for the subscription is created.
        subscription.CreateSyncAgentByDefault = true;

        // 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 pull subscription at the Subscriber.
        subscription.Create();

        Boolean registered = false;

        // Verify that the subscription is not already registered.
        foreach (TransSubscription existing
            in publication.EnumSubscriptions())
        {
            if (existing.SubscriberName == subscriberName
                && existing.SubscriptionDBName == subscriptionDbName)
            {
                registered = true;
            }
        }
        if (!registered)
        {
            // Register the subscription with the Publisher.
            publication.MakePullSubscriptionWellKnown(
                subscriberName, subscriptionDbName,
                SubscriptionSyncType.Automatic,
                TransSubscriberType.ReadOnly);
        }
    }
    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
{
    subscriberConn.Disconnect();
    publisherConn.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 connections to the Publisher and Subscriber.
Dim subscriberConn As ServerConnection = New ServerConnection(subscriberName)
Dim publisherConn As ServerConnection = New ServerConnection(publisherName)

' Create the objects that we need.
Dim publication As TransPublication
Dim subscription As TransPullSubscription

Try
    ' Connect to the Publisher and Subscriber.
    subscriberConn.Connect()
    publisherConn.Connect()

    ' Ensure that the publication exists and that 
    ' it supports pull subscriptions.
    publication = New TransPublication()
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName
    publication.ConnectionContext = publisherConn

    If publication.IsExistingObject Then
        If (publication.Attributes And PublicationAttributes.AllowPull) = 0 Then
            publication.Attributes = publication.Attributes _
            Or PublicationAttributes.AllowPull
        End If

        ' Define the pull subscription.
        subscription = New TransPullSubscription()
        subscription.ConnectionContext = subscriberConn
        subscription.PublisherName = publisherName
        subscription.PublicationName = publicationName
        subscription.PublicationDBName = publicationDbName
        subscription.DatabaseName = subscriptionDbName
        subscription.Description = "Pull subscription to " + publicationDbName _
        + " on " + subscriberName + "."

        ' Specify the Windows login credentials for the Distribution Agent job.
        subscription.SynchronizationAgentProcessSecurity.Login = winLogin
        subscription.SynchronizationAgentProcessSecurity.Password = winPassword

        ' Make sure that the agent job for the subscription is created.
        subscription.CreateSyncAgentByDefault = True

        ' 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 pull subscription at the Subscriber.
        subscription.Create()

        Dim registered As Boolean = False

        ' Verify that the subscription is not already registered.
        For Each existing As TransSubscription In publication.EnumSubscriptions()
            If existing.SubscriberName = subscriberName And _
                existing.SubscriptionDBName = subscriptionDbName Then
                registered = True
            End If
        Next existing
        If Not registered Then
            ' Register the subscription with the Publisher.
            publication.MakePullSubscriptionWellKnown( _
             subscriberName, subscriptionDbName, _
             SubscriptionSyncType.Automatic, _
             TransSubscriberType.ReadOnly)
        End If
    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
    subscriberConn.Disconnect()
    publisherConn.Disconnect()
End Try

注釈

既定のコンストラクターは、すべてのフィールドを既定値に初期化します。

適用対象

TransPullSubscription(String, String, String, String, ServerConnection)

プルサブスクリプションを定義するプロパティを使用して TransPullSubscription クラスの新しいインスタンスを作成します。

public:
 TransPullSubscription(System::String ^ subscriptionDBName, System::String ^ publisherName, System::String ^ publicationDBName, System::String ^ publicationName, Microsoft::SqlServer::Management::Common::ServerConnection ^ subscriberConnectionContext);

public TransPullSubscription (string subscriptionDBName, string publisherName, string publicationDBName, string publicationName, Microsoft.SqlServer.Management.Common.ServerConnection subscriberConnectionContext);

new Microsoft.SqlServer.Replication.TransPullSubscription : string * string * string * string * Microsoft.SqlServer.Management.Common.ServerConnection -> Microsoft.SqlServer.Replication.TransPullSubscription

Public Sub New (subscriptionDBName As String, publisherName As String, publicationDBName As String, publicationName As String, subscriberConnectionContext As ServerConnection)

パラメーター

subscriptionDBName: String

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

publisherName: String

パブリッシャーの名前を指定する String 値です。

publicationDBName: String

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

publicationName: String

パブリケーションの名前を指定する String 値です。

subscriberConnectionContext: ServerConnection

サブスクライバー接続を指定する ServerConnection オブジェクトです。

適用対象

TransPullSubscription(String, String, String, String, ServerConnection, Boolean)

プルサブスクリプション、およびサブスクリプションのエージェントジョブを作成するかどうかを定義するプロパティを使用して、TransPullSubscription クラスの新しいインスタンスを作成します。

public:
 TransPullSubscription(System::String ^ subscriptionDBName, System::String ^ publisherName, System::String ^ publicationDBName, System::String ^ publicationName, Microsoft::SqlServer::Management::Common::ServerConnection ^ subscriberConnectionContext, bool createDistributionAgentByDefault);

public TransPullSubscription (string subscriptionDBName, string publisherName, string publicationDBName, string publicationName, Microsoft.SqlServer.Management.Common.ServerConnection subscriberConnectionContext, bool createDistributionAgentByDefault);

new Microsoft.SqlServer.Replication.TransPullSubscription : string * string * string * string * Microsoft.SqlServer.Management.Common.ServerConnection * bool -> Microsoft.SqlServer.Replication.TransPullSubscription

Public Sub New (subscriptionDBName As String, publisherName As String, publicationDBName As String, publicationName As String, subscriberConnectionContext As ServerConnection, createDistributionAgentByDefault As Boolean)

パラメーター

subscriptionDBName: String

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

publisherName: String

パブリッシャーの名前を指定する String 値です。

publicationDBName: String

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

publicationName: String

パブリケーションの名前を指定する String 値です。

subscriberConnectionContext: ServerConnection

サブスクライバー接続を指定する ServerConnection オブジェクトです。

createDistributionAgentByDefault: Boolean

サブスクリプションを同期するために、ディストリビューションエージェントジョブを作成するかどうかを示す Boolean 値です。

適用対象

TransPullSubscription コンストラクター

定義

オーバーロード

注釈

TransPullSubscription()

例

注釈

適用対象

TransPullSubscription(String, String, String, String, ServerConnection)

パラメーター

適用対象

TransPullSubscription(String, String, String, String, ServerConnection, Boolean)

パラメーター

適用対象

その他のリソース