[アーティクル]
04/01/2012

MergePullSubscription クラス

マージパブリケーションに対するプルサブスクリプションを表します。

継承階層

System. . :: . .Object
  Microsoft.SqlServer.Replication. . :: . .ReplicationObject
    Microsoft.SqlServer.Replication. . :: . .PullSubscription
      Microsoft.SqlServer.Replication..::..MergePullSubscription

名前空間: Microsoft.SqlServer.Replication
アセンブリ: Microsoft.SqlServer.Rmo (Microsoft.SqlServer.Rmo.dll)

構文

'宣言
Public NotInheritable Class MergePullSubscription _
    Inherits PullSubscription
'使用
Dim instance As MergePullSubscription

public sealed class MergePullSubscription : PullSubscription

public ref class MergePullSubscription sealed : public PullSubscription

[<SealedAttribute>]
type MergePullSubscription =  
    class
        inherit PullSubscription
    end

public final class MergePullSubscription extends PullSubscription

MergePullSubscription 型は、以下のメンバーを公開しています。

コンストラクター

	名前	説明
	MergePullSubscription() () () ()	MergePullSubscription クラスの新しいインスタンスを作成します。
	MergePullSubscription(String, String, String, String, ServerConnection)	指定されたデータベース、パブリッシャ、パブリケーション、およびサブスクライバ接続を使用して、MergePullSubscription クラスの新しいインスタンスを作成します。
	MergePullSubscription(String, String, String, String, ServerConnection, Boolean)	指定されたデータベース、パブリッシャ、パブリケーション、およびサブスクライバ接続と、エージェントジョブを作成するかどうかの指定に基づいて、MergePullSubscription クラスの新しいインスタンスを作成します。

先頭に戻る

プロパティ

	名前	説明
	AgentJobId	サブスクリプションの同期に使用されるエージェントジョブの ID を取得します。 (PullSubscription から継承されています。)
	AgentOffload	エージェントジョブの作成時と異なるコンピュータ上で同期エージェントを実行するかどうかを取得します。値の設定も可能です。このプロパティは、Microsoft SQL Server 2005 以降を実行しているディストリビュータではサポートされなくなりました。 (PullSubscription から継承されています。)
	AgentOffloadServer	リモートエージェントのアクティブ化を使用するとき、エージェントが実行されるリモートコンピュータの名前を取得します。値の設定も可能です。 (PullSubscription から継承されています。)
	AgentSchedule	サブスクリプションの同期に使用されるエージェントジョブのスケジュールを取得します。 (PullSubscription から継承されています。)
	AltSnapshotFolder	ディストリビュータ上の既定のスナップショットの場所を使用しない場合、パブリケーションスナップショットファイルの場所を取得します。値の設定も可能です。 (PullSubscription から継承されています。)
	CachePropertyChanges	レプリケーションプロパティに加えられた変更をキャッシュするか、またはすぐに適用するかを取得します。値の設定も可能です。 (ReplicationObject から継承されています。)
	ConnectionContext	Microsoft SQL Server のインスタンスへの接続を取得します。値の設定も可能です。 (ReplicationObject から継承されています。)
	CreateSyncAgentByDefault	レプリケーションエージェントを起動してサブスクリプションを同期するエージェントジョブが、サブスクリプションの作成時に作成されるかどうかを取得します。値の設定も可能です。 (PullSubscription から継承されています。)
	DatabaseName	サブスクリプションデータベースの名前を取得します。値の設定も可能です。 (PullSubscription から継承されています。)
	Description	プルサブスクリプションの説明テキストを取得します。値の設定も可能です。 (PullSubscription から継承されています。)
	DistributorName	ディストリビュータであり、サブスクリプションがサブスクライブするパブリケーションをディストリビュートしている Microsoft SQL Server のインスタンスを取得します。値の設定も可能です。 (PullSubscription から継承されています。)
	DistributorSecurity	ディストリビュータへの接続に使用されるセキュリティコンテキストを取得します。 (PullSubscription から継承されています。)
	DynamicSnapshotLocation	パラメータ化された行フィルタがパブリケーションで使用されている場合に、サブスクリプション固有のスナップショットファイルの場所を取得します。値の設定も可能です。
	EnabledForSynchronizationManager	Windows 同期マネージャを使用してサブスクリプションを同期できるかどうかを指定します。 (PullSubscription から継承されています。)
	FtpAddress	インフラストラクチャです。 (PullSubscription から継承されています。)
	FtpLogin	インフラストラクチャです。 (PullSubscription から継承されています。)
	FtpPassword	インフラストラクチャです。 (PullSubscription から継承されています。)
	FtpPort	インフラストラクチャです。 (PullSubscription から継承されています。)
	HostName	サブスクライバのデータパーティションを定義するパラメータ化された行フィルタで HOST_NAME 関数が使用されている場合に、この関数に渡される値を取得します。値の設定も可能です。
	InternetLogin	Web 同期で Web サーバーに接続するときに HTTP 基本認証で使用されるログインを取得します。値の設定も可能です。
	InternetPassword	Web 同期で Web サーバーに接続するときに提供される InternetLogin 値のパスワードを取得します。値の設定も可能です。
	InternetSecurityMode	Web 同期で Web サーバーに接続するときに使用される HTTP 認証方法を取得します。値の設定も可能です。
	InternetTimeout	Web 同期で Web サーバーに接続するときの HTTP タイムアウト (秒単位) を取得します。値の設定も可能です。
	InternetUrl	Web 同期を使用してサブスクリプションの同期をとるときに使用する URL を取得します。値の設定も可能です。
	IsExistingObject	サーバーにオブジェクトが存在するかどうかを取得します。 (ReplicationObject から継承されています。)
	LastAgentDateTime	サブスクリプションの同期が最後にとられた日付と時刻を取得します。 (PullSubscription から継承されています。)
	LastAgentStatus	サブスクリプションの最新の同期状態を取得します。 (PullSubscription から継承されています。)
	LastAgentSummary	サブスクリプションの最新の同期の結果の概要を取得します。 (PullSubscription から継承されています。)
	Name	プルサブスクリプション用に生成された名前を取得します。 (PullSubscription から継承されています。)
	Priority	サブスクリプション間の競合を解決するときに使用される、他のサーバーサブスクリプションに対するこのサーバーサブスクリプションの重み付けを取得します。値の設定も可能です。
	PublicationDBName	パブリケーションデータベースの名前を取得します。値の設定も可能です。 (PullSubscription から継承されています。)
	PublicationName	サブスクリプションがサブスクライブするパブリケーションの名前を取得します。値の設定も可能です。 (PullSubscription から継承されています。)
	PublisherName	パブリッシャの名前を取得します。値の設定も可能です。 (PullSubscription から継承されています。)
	PublisherSecurity	パブリッシャに接続するときに同期エージェントで使用されるセキュリティコンテキストを取得します。値の設定も可能です。 (PullSubscription から継承されています。)
	SecureFtpPassword	インフラストラクチャです。 (PullSubscription から継承されています。)
	SecureInternetPassword	HTTP 基本認証を使用して Web サーバーに接続するときに使用されるパスワードを SecureString オブジェクトとして設定します。
	SqlServerName	このオブジェクトの接続先となる Microsoft SQL Server インスタンスの名前を取得します。 (ReplicationObject から継承されています。)
	SubscriberSecurity	サブスクライバに接続するときに同期エージェントで使用されるセキュリティコンテキストを取得します。 (PullSubscription から継承されています。)
	SubscriberType	サブスクリプションがサーバーサブスクリプションかクライアントサブスクリプションかを取得します。値の設定も可能です。
	SubscriptionId	サブスクリプション ID 値を取得します。 (PullSubscription から継承されています。)
	SubscriptionType	プッシュサブスクリプション、プルサブスクリプション、または匿名サブスクリプションに対して、サブスクリプションを登録するかどうかを取得します。 (PullSubscription から継承されています。)
	SynchronizationAgent	サブスクリプションの同期に使用できるマージエージェントのインスタンスを表すオブジェクトを取得します。
	SynchronizationAgentProcessSecurity	Microsoft Windows アカウントを指定する場合に使用されるセキュリティコンテキストを取得します。このアカウントに基づいて、同期エージェントジョブが実行され、サブスクリプションが同期されます。 (PullSubscription から継承されています。)
	SyncType	サブスクライバでデータが初期化される方法を取得します。値の設定も可能です。
	Type	インフラストラクチャです。 (PullSubscription から継承されています。)
	UseFtp	プルサブスクリプションの初期化に必要なスナップショットファイルに、同期エージェントがファイル転送プロトコル (FTP) を使用してアクセスするかどうかを取得します。値の設定も可能です。 (PullSubscription から継承されています。)
	UseInteractiveResolver	同期処理中にインタラクティブ競合回避モジュールを使用するかどうかを取得します。値の設定も可能です。
	UserData	ユーザーが独自のデータをオブジェクトにアタッチすることを許可するオブジェクトプロパティを取得します。値の設定も可能です。 (ReplicationObject から継承されています。)
	UseWebSynchronization	サブスクリプションの同期に Web 同期を使用するかどうかを取得します。値の設定も可能です。
	WorkingDirectory	ダウンロードされたスナップショットファイルの一時的な格納と解凍に使用する、サブスクライバ上のディレクトリへのパスを取得します。値の設定も可能です。 (PullSubscription から継承されています。)

先頭に戻る

メソッド

	名前	説明
	CheckValidCreation	インフラストラクチャです。 (ReplicationObject から継承されています。)
	CheckValidDefinition	インフラストラクチャです。 (PullSubscription から継承されています。)
	CommitPropertyChanges	キャッシュされているすべてのプロパティ変更ステートメントを、Microsoft SQL Server のインスタンスに送信します。 (ReplicationObject から継承されています。)
	Create	サブスクライバ上にプルサブスクリプションを作成します。 (PullSubscription から継承されています。)
	CustomEnabledForSyncMgr	インフラストラクチャです。 (PullSubscription から継承されています。)
	Decouple	参照先のレプリケーションオブジェクトをサーバーから切断します。 (ReplicationObject から継承されています。)
	EnumSynchronizationPartners	代替同期パートナーを返します。
	Equals	(Object から継承されています。)
	Finalize	(Object から継承されています。)
	GetChangeCommand	インフラストラクチャです。 (ReplicationObject から継承されています。)
	GetCreateCommand	インフラストラクチャです。 (ReplicationObject から継承されています。)
	GetDropCommand	インフラストラクチャです。 (ReplicationObject から継承されています。)
	GetHashCode	(Object から継承されています。)
	GetType	(Object から継承されています。)
	InitMemberVariables	インフラストラクチャです。 (PullSubscription から継承されています。)
	InternalRefresh	インフラストラクチャです。 (ReplicationObject から継承されています。)
	LastAgentJobHistoryInfo	最後に実行された同期エージェントジョブに関する情報を返します。 (PullSubscription から継承されています。)
	Load	サーバーから既存のオブジェクトのプロパティを読み込みます。 (ReplicationObject から継承されています。)
	LoadProperties	サーバーから既存のオブジェクトのプロパティを読み込みます。 (ReplicationObject から継承されています。)
	MemberwiseClone	(Object から継承されています。)
	Refresh	オブジェクトのプロパティを再度読み込みます。 (ReplicationObject から継承されています。)
	Reinitialize	マージプルサブスクリプションに再初期化のマークを付けます。
	Remove	プルサブスクリプションを削除します。 (PullSubscription から継承されています。)
	Script	PullSubscription オブジェクトの現在のプロパティ設定に基づいてプルサブスクリプションを作成または削除する Transact-SQL スクリプトを返します。 (PullSubscription から継承されています。)
	StopSynchronizationJob	現在サブスクリプションの同期を実行しているマージエージェントジョブの停止を試みます。 (PullSubscription. . :: . .StopSynchronizationJob() () () () をオーバーライドします。)
	SynchronizeWithJob	エージェントジョブを非同期に開始して、プルサブスクリプションを同期します。 (PullSubscription. . :: . .SynchronizeWithJob() () () () をオーバーライドします。)
	ToString	(Object から継承されています。)

先頭に戻る

説明

プルサブスクリプションでは、マージエージェントはサブスクライバで実行されます。

この名前空間、クラス、またはメンバは、Microsoft .NET Framework 2.0 でのみサポートされています。

スレッドセーフ

この型の public static (Microsoft Visual Basic では Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

使用例

         // Define the Publisher, publication, and databases.
            string publicationName = "AdvWorksSalesOrdersMerge";
            string publisherName = publisherInstance;
            string subscriberName = subscriberInstance;
            string subscriptionDbName = "AdventureWorks2008R2Replica";
            string publicationDbName = "AdventureWorks2008R2";
            string hostname = @"adventure-works\garrett1";

            //Create connections to the Publisher and Subscriber.
            ServerConnection subscriberConn = new ServerConnection(subscriberName);
            ServerConnection publisherConn = new ServerConnection(publisherName);

            // Create the objects that we need.
            MergePublication publication;
            MergePullSubscription subscription;

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

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

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

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

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

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

                    // Create the pull subscription at the Subscriber.
                    subscription.Create();

                    Boolean registered = false;

                    // Verify that the subscription is not already registered.
                    foreach (MergeSubscription existing
                        in publication.EnumSubscriptions())
                    {
                        if (existing.SubscriberName == subscriberName
                            && existing.SubscriptionDBName == subscriptionDbName
                            && existing.SubscriptionType == SubscriptionOption.Pull)
                        {
                            registered = true;
                        }
                    }
                    if (!registered)
                    {
                        // Register the local subscription with the Publisher.
                        publication.MakePullSubscriptionWellKnown(
                            subscriberName, subscriptionDbName,
                            SubscriptionSyncType.Automatic,
                            MergeSubscriberType.Local, 0);
                    }
                }
                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 = "AdvWorksSalesOrdersMerge"
Dim publisherName As String = publisherInstance
Dim subscriberName As String = subscriberInstance
Dim subscriptionDbName As String = "AdventureWorks2008R2Replica"
Dim publicationDbName As String = "AdventureWorks2008R2"
Dim hostname As String = "adventure-works\garrett1"

'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 MergePublication
Dim subscription As MergePullSubscription

Try
    ' Connect to the Subscriber.
    subscriberConn.Connect()

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

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

        ' Define the pull subscription.
        subscription = New MergePullSubscription()
        subscription.ConnectionContext = subscriberConn
        subscription.PublisherName = publisherName
        subscription.PublicationName = publicationName
        subscription.PublicationDBName = publicationDbName
        subscription.DatabaseName = subscriptionDbName
        subscription.HostName = hostname

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

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

        ' 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 MergeSubscription In _
        publication.EnumSubscriptions()
            If existing.SubscriberName = subscriberName Then
                registered = True
            End If
        Next
        If Not registered Then
            ' Register the local subscription with the Publisher.
            publication.MakePullSubscriptionWellKnown( _
             subscriberName, subscriptionDbName, _
             SubscriptionSyncType.Automatic, _
             MergeSubscriberType.Local, 0)
        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

スレッドセーフ

この型の public static (Visual Basic では Shared) のメンバーはすべて、スレッドセーフです。インスタンスメンバーの場合は、スレッドセーフであるとは限りません。

次の方法で共有

MergePullSubscription クラス

継承階層

構文

コンストラクター

プロパティ

メソッド

説明

スレッドセーフ

使用例

スレッドセーフ

関連項目

参照

その他の技術情報

その他のリソース

次の方法で共有

MergePullSubscription クラス

継承階層

構文

コンストラクター

プロパティ

メソッド

説明

スレッド セーフ

使用例

スレッド セーフ

関連項目

参照

その他の技術情報

その他のリソース

スレッドセーフ

スレッドセーフ