Udostępnij za pośrednictwem

  • Artykuł

Klasa TransPullSubscription

Reprezentuje subskrypcja wciągana do publikacja transakcyjnych.

Hierarchia dziedziczenia

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

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

Składnia

'Deklaracja
Public NotInheritable Class TransPullSubscription _
    Inherits PullSubscription
'Użycie
Dim instance As TransPullSubscription

public sealed class TransPullSubscription : PullSubscription

public ref class TransPullSubscription sealed : public PullSubscription

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

public final class TransPullSubscription extends PullSubscription

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

Konstruktorzy

  Nazwa Opis
Metoda publiczna TransPullSubscription() Tworzy nowe wystąpienie TransPullSubscription klasy
Metoda publiczna TransPullSubscription(String, String, String, String, ServerConnection) Tworzy nowe wystąpienie TransPullSubscription klasy z właściwości definiujące subskrypcja wciągana.
Metoda publiczna TransPullSubscription(String, String, String, String, ServerConnection, Boolean) Tworzy nowe wystąpienie TransPullSubscription klasy z właściwości definiujące subskrypcja wciąganaoraz czy utworzyć zadanie agenta dla subskrypcji.

Do góry

Właściwości

  Nazwa Opis
Właściwość publiczna AgentJobId Pobiera identyfikator zadanie agenta, używane do synchronizacji subskrypcja. (Dziedziczony z PullSubscription).
Właściwość publiczna 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).
Właściwość publiczna AgentOffloadServer Pobiera lub ustawia nazwę komputera zdalnego, w którym agent jest uruchamiany podczas korzystania z agenta zdalnego aktywacja. (Dziedziczony z PullSubscription).
Właściwość publiczna AgentSchedule Pobiera harmonogram dla zadanie agenta, używane do synchronizacji subskrypcja. (Dziedziczony z PullSubscription).
Właściwość publiczna 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).
Właściwość publiczna Attributes Pobiera lub ustawia atrybuty transakcyjnych publikacja, które są obsługiwane przez subskrypcja.
Właściwość publiczna CachePropertyChanges Pobiera lub ustawia, czy zmiany właściwości replikacja w pamięci podręcznej, czy stosuje je niezwłocznie. (Dziedziczony z ReplicationObject).
Właściwość publiczna ConnectionContext Gets or sets the connection to an instance of Microsoft SQL Server. (Dziedziczony z ReplicationObject).
Właściwość publiczna CreateSyncAgentByDefault Pobiera lub ustawia, czy zadanie agenta, używany do uruchamiania agenta replikacji do synchronizacji subskrypcja jest tworzony podczas tworzenia subskrypcja. (Dziedziczony z PullSubscription).
Właściwość publiczna DatabaseName Pobiera lub ustawia nazwę baza danych subskrypcja. (Dziedziczony z PullSubscription).
Właściwość publiczna Description Pobiera lub ustawia tekstowy opis subskrypcja wciągana. (Dziedziczony z PullSubscription).
Właściwość publiczna 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).
Właściwość publiczna DistributorSecurity Pobiera kontekstu zabezpieczeń używane do łączenia z dystrybutora. (Dziedziczony z PullSubscription).
Właściwość publiczna DtsPackageLocation Pobiera lub Ustawia lokalizację pakiet usług transformacji danych (DTS), używany z subskrypcja umożliwiającego przejście.
Właściwość publiczna DtsPackageName Pobiera lub ustawia nazwę pakiet usług transformacji danych (DTS) używane w subskrypcja umożliwiającego przejście.
Właściwość publiczna DtsPackagePassword Ustawia hasło używane z subskrypcja umożliwiającego przejście.
Właściwość publiczna EnabledForSynchronizationManager Określa, czy subskrypcja mogą być synchronizowane za pomocą Menedżera synchronizacji systemu Windows. (Dziedziczony z PullSubscription).
Właściwość publiczna FtpAddress Infrastruktura. (Dziedziczony z PullSubscription).
Właściwość publiczna FtpLogin Infrastruktura. (Dziedziczony z PullSubscription).
Właściwość publiczna FtpPassword Infrastruktura. (Dziedziczony z PullSubscription).
Właściwość publiczna FtpPort Infrastruktura. (Dziedziczony z PullSubscription).
Właściwość publiczna IsExistingObject Pobiera się, czy obiekt istnieje na serwerze. (Dziedziczony z ReplicationObject).
Właściwość publiczna LastAgentDateTime Pobiera data i czas, kiedy był ostatnio synchronizowany subskrypcja. (Dziedziczony z PullSubscription).
Właściwość publiczna LastAgentStatus Pobiera stan ostatniej synchronizacji subskrypcja. (Dziedziczony z PullSubscription).
Właściwość publiczna LastAgentSummary Pobiera podsumowanie wynik ostatniej synchronizacji subskrypcja. (Dziedziczony z PullSubscription).
Właściwość publiczna LastSummaryDateTime Pobiera Data i czas zakończonej ostatniej synchronizacji.
Właściwość publiczna Name Pobiera nazwę generowane dla subskrypcja wciągana. (Dziedziczony z PullSubscription).
Właściwość publiczna PublicationDBName Pobiera lub ustawia nazwę baza danych publikacja. (Dziedziczony z PullSubscription).
Właściwość publiczna PublicationName Pobiera lub ustawia nazwę publikacja, do której subskrybuje subskrypcja. (Dziedziczony z PullSubscription).
Właściwość publiczna PublisherName Pobiera lub ustawia nazwę Wydawca. (Dziedziczony z PullSubscription).
Właściwość publiczna PublisherSecurity Pobiera lub ustawia kontekst zabezpieczeń, używana przez agenta synchronizacji podczas łączenia się z Wydawca. (Dziedziczony z PullSubscription).
Właściwość publiczna SecureFtpPassword Infrastruktura. (Dziedziczony z PullSubscription).
Właściwość publiczna SqlServerName Gets the name of the Microsoft SQL Server instance to which this object is connected. (Dziedziczony z ReplicationObject).
Właściwość publiczna SubscriberSecurity Pobiera kontekście zabezpieczeń, który jest używany przez agenta synchronizacji podczas łączenia się z subskrybenta. (Dziedziczony z PullSubscription).
Właściwość publiczna SubscriberType Pobiera lub ustawia zachowanie aktualizowania subskrypcja.
Właściwość publiczna SubscriptionId Pobiera wartość Identyfikatora subskrypcja. (Dziedziczony z PullSubscription).
Właściwość publiczna SubscriptionType Pobiera czy rejestracji subskrypcji jest wypychanie, ściągania lub subskrypcja anonimowa. (Dziedziczony z PullSubscription).
Właściwość publiczna SynchronizationAgent Pobiera obiekt, który reprezentuje wystąpienie agenta dystrybucji, używany do synchronizacji subskrypcja.
Właściwość publiczna 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).
Właściwość publiczna Type Infrastruktura. (Dziedziczony z PullSubscription).
Właściwość publiczna 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).
Właściwość publiczna UserData Pobiera lub ustawia właściwość obiektu, który umożliwia użytkownikom dołączanie własnych danych do obiektu. (Dziedziczony z ReplicationObject).
Właściwość publiczna 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
Metoda chroniona CheckValidCreation Infrastruktura. (Dziedziczony z ReplicationObject).
Metoda chroniona CheckValidDefinition Infrastruktura. (Dziedziczony z PullSubscription).
Metoda publiczna CommitPropertyChanges Sends all the cached property change statements to the instance of Microsoft SQL Server. (Dziedziczony z ReplicationObject).
Metoda publiczna Create Tworzy subskrypcja wciągana na subskrybenta. (Dziedziczony z PullSubscription).
Metoda chroniona CustomEnabledForSyncMgr Infrastruktura. (Dziedziczony z PullSubscription).
Metoda publiczna Decouple Oddzielono obiekt odwołanie replikacja z serwera. (Dziedziczony z ReplicationObject).
Metoda publiczna Equals (Dziedziczony z Object).
Metoda chroniona Finalize (Dziedziczony z Object).
Metoda chroniona GetChangeCommand Infrastruktura. (Dziedziczony z ReplicationObject).
Metoda chroniona GetCreateCommand Infrastruktura. (Dziedziczony z ReplicationObject).
Metoda chroniona GetDropCommand Infrastruktura. (Dziedziczony z ReplicationObject).
Metoda publiczna GetHashCode (Dziedziczony z Object).
Metoda publiczna GetType (Dziedziczony z Object).
Metoda chroniona InitMemberVariables Infrastruktura. (Dziedziczony z PullSubscription).
Metoda chroniona InternalRefresh Infrastruktura. (Dziedziczony z ReplicationObject).
Metoda publiczna LastAgentJobHistoryInfo Zwraca informacje o ostatniego uruchomienia zadanie agenta synchronizacji. (Dziedziczony z PullSubscription).
Metoda publiczna Load Ładuje właściwości istniejącego obiektu z serwera. (Dziedziczony z ReplicationObject).
Metoda publiczna LoadProperties Ładuje właściwości istniejącego obiektu z serwera. (Dziedziczony z ReplicationObject).
Metoda chroniona MemberwiseClone (Dziedziczony z Object).
Metoda publiczna Refresh Ponownie ładuje właściwości obiektu. (Dziedziczony z ReplicationObject).
Metoda publiczna Reinitialize Znaki subskrypcja wciągana dla ponownego inicjowania.
Metoda publiczna Remove Usuwa subskrypcja wciągana. (Dziedziczony z PullSubscription).
Metoda publiczna 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).
Metoda publiczna StopSynchronizationJob Próbuje zatrzymać uruchomione zadanie dystrybucji agenta, który Trwa synchronizowanie subskrypcja. (Zastępuje PullSubscription.StopSynchronizationJob()).
Metoda publiczna SynchronizeWithJob Uruchamia zadanie agenta do synchronizacji subskrypcja. (Zastępuje PullSubscription.SynchronizeWithJob()).
Metoda publiczna ToString (Dziedziczony z Object).

Do góry

Uwagi

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

Ten obszar nazw, klasy lub element członkowski jest obsługiwany tylko w wersja 2.0.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 = "AdvWorksProductTran";
            string publisherName = publisherInstance;
            string subscriberName = subscriberInstance;
            string subscriptionDbName = "AdventureWorks2008R2Replica";
            string publicationDbName = "AdventureWorks2008R2";

            //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 = "AdventureWorks2008R2Replica"
Dim publicationDbName As String = "AdventureWorks2008R2"

'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

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.