• [アーティクル]

Reinitialize メソッド

マージ プル サブスクリプションに再初期化のマークを付けます。

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

構文

'宣言
Public Sub Reinitialize ( _
    uploadFirst As Boolean _
)
'使用
Dim instance As MergePullSubscription
Dim uploadFirst As Boolean

instance.Reinitialize(uploadFirst)

public void Reinitialize(
    bool uploadFirst
)

public:
void Reinitialize(
    bool uploadFirst
)

member Reinitialize : 
        uploadFirst:bool -> unit 

public function Reinitialize(
    uploadFirst : boolean
)

パラメーター

  • uploadFirst
    型: System. . :: . .Boolean
    スナップショットを再適用してサブスクリプションを再初期化する前に、すべての変更をサブスクライバからアップロードするかどうかを指定する Boolean 値です。true の場合、スナップショットを適用する前に変更がアップロードされます。false の場合、変更はアップロードされません。

説明

Reinitialize メソッドを呼び出した後に、サブスクリプションを再初期化するために、同期を開始する必要があります。詳細については、「サブスクリプションを再初期化する方法 (RMO プログラミング)」を参照してください。

Reinitialize メソッドを呼び出すことができるのは、サブスクライバ側の固定サーバー ロール sysadmin のメンバ、またはサブスクリプション データベースの固定データベース ロール db_owner のメンバだけです。

Reinitialize を呼び出すと、sp_reinitmergepullsubscription を実行したのと同じことになります。

MicrosoftSQL Server 7.0 のインスタンスを使用している場合は、uploadFirst パラメータを false に設定しないと例外がスローされます。

Reinitialize メソッドは、MicrosoftSQL Server 2000 と MicrosoftSQL Server 2005 で使用できます。

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

使用例

         // Define server, publication, and database names.
            String subscriberName = subscriberInstance;
            String publisherName = publisherInstance;
            String publicationName = "AdvWorksSalesOrdersMerge";
            String publicationDbName = "AdventureWorks";
            String subscriptionDbName = "AdventureWorksReplica";

            // Create a connection to the Subscriber.
            ServerConnection conn = new ServerConnection(subscriberName);

            MergePullSubscription subscription;

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

                // Define subscription properties.
                subscription = new MergePullSubscription();
                subscription.ConnectionContext = conn;
                subscription.DatabaseName = subscriptionDbName;
                subscription.PublisherName = publisherName;
                subscription.PublicationDBName = publicationDbName;
                subscription.PublicationName = publicationName;

                // If the pull subscription and the job exists, mark the subscription
                // for reinitialization after upload and start the agent job.
                if (subscription.LoadProperties() && subscription.AgentJobId != null)
                {
                    subscription.Reinitialize(true);
                    subscription.SynchronizeWithJob();
                }
                else
                {
                    // Do something here if the subscription does not exist.
                    throw new ApplicationException(String.Format(
                        "A subscription to '{0}' does not exists on {1}",
                        publicationName, subscriberName));
                }
            }
            catch (Exception ex)
            {
                // Do appropriate error handling here.
                throw new ApplicationException("The subscription could not be synchronized.", ex);
            }
            finally
            {
                conn.Disconnect();
            }

' Define server, publication, and database names.
Dim subscriberName As String = subscriberInstance
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publicationDbName As String = "AdventureWorks"
Dim subscriptionDbName As String = "AdventureWorksReplica"

' Create a connection to the Subscriber.
Dim conn As ServerConnection = New ServerConnection(subscriberName)

Dim subscription As MergePullSubscription

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

    ' Define subscription properties.
    subscription = New MergePullSubscription()
    subscription.ConnectionContext = conn
    subscription.DatabaseName = subscriptionDbName
    subscription.PublisherName = publisherName
    subscription.PublicationDBName = publicationDbName
    subscription.PublicationName = publicationName

    ' If the pull subscription and the job exists, mark the subscription
    ' for reinitialization after upload and start the agent job.
    If subscription.LoadProperties() And (Not subscription.AgentJobId Is Nothing) Then
        subscription.Reinitialize(True)
        subscription.SynchronizeWithJob()
    Else
        ' Do something here if the subscription does not exist.
        Throw New ApplicationException(String.Format( _
         "A subscription to '{0}' does not exists on {1}", _
         publicationName, subscriberName))
    End If
Catch ex As Exception
    ' Do appropriate error handling here.
    Throw New ApplicationException("The subscription could not be synchronized.", ex)
Finally
    conn.Disconnect()
End Try