Artykuł
07/22/2011

Klasa MergePullSubscription

Reprezentuje subskrypcja wciągana do publikacja korespondencji seryjnej.

Hierarchia dziedziczenia

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

Przestrzeń nazw: Microsoft.SqlServer.Replication
Zestaw: Microsoft.SqlServer.Rmo (w Microsoft.SqlServer.Rmo.dll)

Składnia

'Deklaracja
Public NotInheritable Class MergePullSubscription _
    Inherits PullSubscription
'Użycie
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

Typ MergePullSubscription uwidacznia następujące elementy członkowskie.

Konstruktorzy

	Nazwa	Opis
	MergePullSubscription()	Tworzy nowe wystąpienie MergePullSubscription klasy
	MergePullSubscription(String, String, String, String, ServerConnection)	Tworzy nowe wystąpienie MergePullSubscription klasy z określonej bazy danych, Wydawca, publikacja i subskrybenta połączenia.
	MergePullSubscription(String, String, String, String, ServerConnection, Boolean)	Tworzy nowe wystąpienie MergePullSubscription klasy z określonej bazy danych, Wydawca publikacja, połączenie subskrybenta i czy utworzone zadanie agenta.

Do góry

Właściwości

	Nazwa	Opis
	AgentJobId	Pobiera identyfikator zadanie agenta, używane do synchronizacji subskrypcja. (Dziedziczony z PullSubscription).
	AgentOffload	Pobiera lub ustawia, czy Agent synchronizacji jest uruchamiany na komputerze innym niż ten, której utworzono zadanie agenta.This property is no longer supported for Distributors running Microsoft SQL Server 2005 and later. (Dziedziczony z PullSubscription).
	AgentOffloadServer	Pobiera lub ustawia nazwę komputera zdalnego, w którym agent jest uruchamiany podczas korzystania z agenta zdalnego aktywacja. (Dziedziczony z PullSubscription).
	AgentSchedule	Pobiera harmonogram dla zadanie agenta, używane do synchronizacji subskrypcja. (Dziedziczony z PullSubscription).
	AltSnapshotFolder	Pobiera lub Ustawia lokalizację, gdzie pliki migawka publikacja są uzyskiwane, gdy nie jest używana domyślna lokalizacja migawka u dystrybutora. (Dziedziczony z PullSubscription).
	CachePropertyChanges	Pobiera lub ustawia, czy zmiany właściwości replikacja w pamięci podręcznej, czy stosuje je niezwłocznie. (Dziedziczony z ReplicationObject).
	ConnectionContext	Gets or sets the connection to an instance of Microsoft SQL Server. (Dziedziczony z ReplicationObject).
	CreateSyncAgentByDefault	Pobiera lub ustawia, czy zadanie agenta, używany do uruchamiania agenta replikacji do synchronizacji subskrypcja jest tworzony podczas tworzenia subskrypcja. (Dziedziczony z PullSubscription).
	DatabaseName	Pobiera lub ustawia nazwę baza danych subskrypcja. (Dziedziczony z PullSubscription).
	Description	Pobiera lub ustawia tekstowy opis subskrypcja wciągana. (Dziedziczony z PullSubscription).
	DistributorName	Gets or sets the instance of Microsoft SQL Server that is the Distributor and is distributing the publication to which the subscription subscribes. (Dziedziczony z PullSubscription).
	DistributorSecurity	Pobiera kontekstu zabezpieczeń używane do łączenia z dystrybutora. (Dziedziczony z PullSubscription).
	DynamicSnapshotLocation	Pobiera lub Ustawia lokalizację pliku dla plików migawka specyficzne dla subskrypcja po publikacja używa sparametryzowany filtr wierszy.
	EnabledForSynchronizationManager	Określa, czy subskrypcja mogą być synchronizowane za pomocą Menedżera synchronizacji systemu Windows. (Dziedziczony z PullSubscription).
	FtpAddress	Infrastruktura. (Dziedziczony z PullSubscription).
	FtpLogin	Infrastruktura. (Dziedziczony z PullSubscription).
	FtpPassword	Infrastruktura. (Dziedziczony z PullSubscription).
	FtpPort	Infrastruktura. (Dziedziczony z PullSubscription).
	HostName	Pobiera lub ustawia wartość dostarczonych do HOST_NAME , gdy funkcja ta jest używana w sparametryzowany filtr wierszy, który definiuje abonenta partycji danych.
	InternetLogin	Pobiera lub ustawia logowania używane z uwierzytelnianiem podstawowym HTTP podczas łączenia się z serwerem sieci Web podczas synchronizacja w sieci Web.
	InternetPassword	Pobiera lub ustawia hasło dla podanej InternetLogin wartość do łączenia z serwerem sieci Web podczas synchronizacja w sieci Web.
	InternetSecurityMode	Pobiera lub Ustawia metoda uwierzytelnianie HTTP używanej przy łączeniu się z serwerem sieci Web podczas synchronizacja w sieci Web.
	InternetTimeout	Pobiera lub ustawia limit czasu protokołu HTTP w sekundach, podczas nawiązywania połączenia z serwerem sieci Web podczas synchronizacja w sieci Web.
	InternetUrl	Pobiera lub ustawia adres URL podczas synchronizacji subskrypcja przy użyciu sieci synchronizacja w sieci Web.
	IsExistingObject	Pobiera się, czy obiekt istnieje na serwerze. (Dziedziczony z ReplicationObject).
	LastAgentDateTime	Pobiera data i czas, kiedy był ostatnio synchronizowany subskrypcja. (Dziedziczony z PullSubscription).
	LastAgentStatus	Pobiera stan ostatniej synchronizacji subskrypcja. (Dziedziczony z PullSubscription).
	LastAgentSummary	Pobiera podsumowanie wynik ostatniej synchronizacji subskrypcja. (Dziedziczony z PullSubscription).
	Name	Pobiera nazwę generowane dla subskrypcja wciągana. (Dziedziczony z PullSubscription).
	Priority	Pobiera lub ustawia wagi tej subskrypcja serwerowa względem innych subskrypcje serwera podczas rozwiązywania konfliktów między subskrypcji.
	PublicationDBName	Pobiera lub ustawia nazwę baza danych publikacja. (Dziedziczony z PullSubscription).
	PublicationName	Pobiera lub ustawia nazwę publikacja, do której subskrybuje subskrypcja. (Dziedziczony z PullSubscription).
	PublisherName	Pobiera lub ustawia nazwę Wydawca. (Dziedziczony z PullSubscription).
	PublisherSecurity	Pobiera lub ustawia kontekst zabezpieczeń, używana przez agenta synchronizacji podczas łączenia się z Wydawca. (Dziedziczony z PullSubscription).
	SecureFtpPassword	Infrastruktura. (Dziedziczony z PullSubscription).
	SecureInternetPassword	Ustawia hasło (jako SecureString obiektu) używane do łączenia z serwerem sieci Web przy użyciu uwierzytelnianie podstawowe HTTP.
	SqlServerName	Gets the name of the Microsoft SQL Server instance to which this object is connected. (Dziedziczony z ReplicationObject).
	SubscriberSecurity	Pobiera kontekście zabezpieczeń, który jest używany przez agenta synchronizacji podczas łączenia się z subskrybenta. (Dziedziczony z PullSubscription).
	SubscriberType	Pobiera lub ustawia, czy subskrypcja jest serwer lub subskrypcja kliencka.
	SubscriptionId	Pobiera wartość Identyfikatora subskrypcja. (Dziedziczony z PullSubscription).
	SubscriptionType	Pobiera czy rejestracji subskrypcji jest wypychanie, ściągania lub subskrypcja anonimowa. (Dziedziczony z PullSubscription).
	SynchronizationAgent	Pobiera obiekt, który reprezentuje wystąpienie agenta scalanie, używany do synchronizacji subskrypcja.
	SynchronizationAgentProcessSecurity	Pobiera kontekst zabezpieczeń, który jest używany do określenia Microsoft konta systemu Windows, pod którym działa zadanie synchronizacji agenta do synchronizacji subskrypcja. (Dziedziczony z PullSubscription).
	SyncType	Pobiera lub ustawia sposób, w którym dane jest inicjowany przez subskrybenta.
	Type	Infrastruktura. (Dziedziczony z PullSubscription).
	UseFtp	Pobiera lub ustawia, czy pliki migawka potrzebne do zainicjowania subskrypcja wciągana są używane przez agenta synchronizacji przy użyciu protokołu FTP (File Transfer Protocol). (Dziedziczony z PullSubscription).
	UseInteractiveResolver	Pobiera lub ustawia, czy interaktywne rozpoznawania nazw jest używana podczas procesu synchronizacji.
	UserData	Pobiera lub ustawia właściwość obiektu, który umożliwia użytkownikom dołączanie własnych danych do obiektu. (Dziedziczony z ReplicationObject).
	UseWebSynchronization	Pobiera lub ustawia, czy subskrypcja jest synchronizowane przy użyciu sieci synchronizacja w sieci Web.
	WorkingDirectory	Pobiera lub ustawia ścieżka katalogu subskrybent używany do tymczasowego przechowywania i dekompresji plików pobranych migawka. (Dziedziczony z PullSubscription).

Do góry

Metody

	Nazwa	Opis
	CheckValidCreation	Infrastruktura. (Dziedziczony z ReplicationObject).
	CheckValidDefinition	Infrastruktura. (Dziedziczony z PullSubscription).
	CommitPropertyChanges	Sends all the cached property change statements to the instance of Microsoft SQL Server. (Dziedziczony z ReplicationObject).
	Create	Tworzy subskrypcja wciągana na subskrybenta. (Dziedziczony z PullSubscription).
	CustomEnabledForSyncMgr	Infrastruktura. (Dziedziczony z PullSubscription).
	Decouple	Oddzielono obiekt odwołanie replikacja z serwera. (Dziedziczony z ReplicationObject).
	EnumSynchronizationPartners	Zwraca alternatywny partnerów do synchronizacji
	Equals	(Dziedziczony z Object).
	Finalize	(Dziedziczony z Object).
	GetChangeCommand	Infrastruktura. (Dziedziczony z ReplicationObject).
	GetCreateCommand	Infrastruktura. (Dziedziczony z ReplicationObject).
	GetDropCommand	Infrastruktura. (Dziedziczony z ReplicationObject).
	GetHashCode	(Dziedziczony z Object).
	GetType	(Dziedziczony z Object).
	InitMemberVariables	Infrastruktura. (Dziedziczony z PullSubscription).
	InternalRefresh	Infrastruktura. (Dziedziczony z ReplicationObject).
	LastAgentJobHistoryInfo	Zwraca informacje o ostatniego uruchomienia zadanie agenta synchronizacji. (Dziedziczony z PullSubscription).
	Load	Ładuje właściwości istniejącego obiektu z serwera. (Dziedziczony z ReplicationObject).
	LoadProperties	Ładuje właściwości istniejącego obiektu z serwera. (Dziedziczony z ReplicationObject).
	MemberwiseClone	(Dziedziczony z Object).
	Refresh	Ponownie ładuje właściwości obiektu. (Dziedziczony z ReplicationObject).
	Reinitialize	Scalanie oznacza subskrypcja wciągana dla ponownego inicjowania.
	Remove	Usuwa subskrypcja wciągana. (Dziedziczony z PullSubscription).
	Script	Zwraca Transact-SQL skryptów do tworzenia lub usuwania subskrypcja wciągana oparte na bieżące ustawienie właściwość PullSubscription obiektu. (Dziedziczony z PullSubscription).
	StopSynchronizationJob	Próbuje zatrzymać uruchomione zadanie scalić agenta, który Trwa synchronizowanie subskrypcja. (Zastępuje PullSubscription.StopSynchronizationJob()).
	SynchronizeWithJob	Uruchamia zadanie agenta asynchronicznie, aby zsynchronizować subskrypcja wciągana. (Zastępuje PullSubscription.SynchronizeWithJob()).
	ToString	(Dziedziczony z Object).

Do góry

Uwagi

Dla subskrypcja wciągana, Agent scalania jest uruchamiany przez subskrybenta.

Ten obszar nazw, klasy lub element członkowski jest obsługiwany tylko w wersja 2.0 Microsoft .NET Framework.

Bezpieczeństwo wątków

Wszystkie publiczne statyczne (Shared w Microsoft języka Visual Basic) elementy tego typu są bezpieczne dla operacji wielowątkowe.Nie ma gwarancji, że elementy członkowskie wystąpień będą bezpieczne dla wątków.

Przykłady

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

Bezpieczeństwo wątków

Wszystkie publiczne statyczny (Shared w języku Visual Basic) elementy członkowskie tego typu są bezpieczne dla wątków. Nie ma gwarancji, że elementy członkowskie wystąpień będą bezpieczne dla wątków.

Zobacz także

Odwołanie

Przestrzeń nazw Microsoft.SqlServer.Replication

Inne zasoby

Jak Tworzenie subskrypcji ściąganej (Programowanie RMO)

Sales Orders Sample for Merge Replication

Udostępnij za pośrednictwem

Klasa MergePullSubscription

Hierarchia dziedziczenia

Składnia

Konstruktorzy

Właściwości

Metody

Uwagi

Bezpieczeństwo wątków

Przykłady

Bezpieczeństwo wątków

Zobacz także

Odwołanie

Inne zasoby

Dodatkowe zasoby