Artykuł
07/22/2011

Klasa TransSubscription

Reprezentuje subskrypcja wypychana do publikacja transakcyjnych lub migawka.

Hierarchia dziedziczenia

System.Object
  Microsoft.SqlServer.Replication.ReplicationObject
    Microsoft.SqlServer.Replication.Subscription
      Microsoft.SqlServer.Replication.TransSubscription

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

Składnia

'Deklaracja
Public NotInheritable Class TransSubscription _
    Inherits Subscription
'Użycie
Dim instance As TransSubscription

public sealed class TransSubscription : Subscription

public ref class TransSubscription sealed : public Subscription

[<SealedAttribute>]
type TransSubscription =  
    class
        inherit Subscription
    end

public final class TransSubscription extends Subscription

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

Konstruktorzy

	Nazwa	Opis
	TransSubscription()	Tworzy nowe wystąpienie TransSubscription klasy
	TransSubscription(String, String, String, String, ServerConnection)	Creates a new instance of the TransSubscription class with the specified publication, database, Subscriber, and subscriber database, and with the specified connection to the instance of Microsoft SQL Server.

Do góry

Właściwości

	Nazwa	Opis
	AgentJobId	Pobiera identyfikator zadanie agenta, używane do synchronizacji subskrypcja. (Dziedziczony z Subscription).
	AgentOffload	Pobiera lub ustawia, czy agent synchronizacji działa 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 Subscription).
	AgentOffloadServer	Pobiera lub ustawia nazwę komputera zdalnego, w którym agent jest uruchamiany podczas korzystania z agenta zdalnego aktywacja. (Dziedziczony z Subscription).
	AgentSchedule	Pobiera harmonogram dla zadanie agenta, używane do synchronizacji subskrypcja. (Dziedziczony z Subscription).
	BackupInformation	Pobiera lub ustawia informacje potrzebne do zainicjowania subskrypcja z kopia zapasowa.
	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żywane do synchronizacji subskrypcja jest tworzona domyślnie. (Dziedziczony z Subscription).
	DatabaseName	Pobiera lub ustawia nazwę baza danych publikacja. (Dziedziczony z Subscription).
	DtsPackageLocation	Gets or sets the location of the Microsoft SQL Server 2000 Data Transformation Services (DTS) package.
	DtsPackageName	Gets or sets the name of the Microsoft SQL Server 2000 Data Transformation Services (DTS) package that is applied at the Subscriber.
	DtsPackagePassword	Sets the password used to run the Microsoft SQL Server 2000 Data Transformation Services (DTS) package.
	EnabledForSynchronizationManager	Określa, czy subskrypcja mogą być synchronizowane za pomocą Microsoft Menedżer synchronizacji systemu Windows. (Dziedziczony z Subscription).
	FullSubscription	Infrastruktura.
	IsExistingObject	Pobiera się, czy obiekt istnieje na serwerze. (Dziedziczony z ReplicationObject).
	LoopBackDetection	Pobiera lub ustawia, czy Agent dystrybucji wysyła transakcje utworzone przez subskrybenta do subskrybenta.
	Name	Pobiera nazwę przypisaną do istniejącej subskrypcja. (Dziedziczony z Subscription).
	PublicationName	Pobiera lub ustawia nazwę publikacja, do której subskrybuje subskrypcja. (Dziedziczony z Subscription).
	PublisherName	Pobiera lub ustawia nazwę Wydawca podczas subskrypcja należy do nie- SQL Server Wydawca.
	SecureDtsPackagePassword	Sets the password (as a SecureString object) used to run the Microsoft SQL Server 2000 Data Transformation Services (DTS) package.
	SqlServerName	Gets the name of the Microsoft SQL Server instance to which this object is connected. (Dziedziczony z ReplicationObject).
	Status	Pobiera status subskrypcja. (Dziedziczony z Subscription).
	SubscriberCatalog	Pobiera lub ustawia wykazu używane podczas nawiązywania połączenia w OLE DB dostawca dla nie-SQL Server subskrybenta.
	SubscriberDatasource	Nazwa źródło danych, jak zrozumiałe dla dostawca OLE DB dla nie-SQL Server subskrybenta.
	SubscriberDatasourceType	Identyfikuje typ źródło danych, która jest różna-SQL Server subskrybenta.
	SubscriberLocation	Lokalizację bazy danych jako zrozumiałe dla dostawca OLE DB dla niehandlowego-SQL Server subskrybenta.
	SubscriberName	Gets or sets the name of the instance of Microsoft SQL Server that is the Subscriber. (Dziedziczony z Subscription).
	SubscriberProvider	Unikatowy identyfikator programowych (PROGID) z którą dostawca OLE DB dla niehandlowego-SQL Server zarejestrowanych subskrybenta
	SubscriberProviderString	Połączenie specyficznym dla dostawca OLE DB ciąg jest używany do łączenia się ze źródłem danych dla nie-SQL Server abonentów.
	SubscriberSecurity	Pobiera kontekstu zabezpieczeń używane do łączenia z subskrybenta. (Dziedziczony z Subscription).
	SubscriberType	Pobiera lub ustawia zachowanie aktualizowania zmian danych przez subskrybenta.
	SubscriptionDBName	Pobiera lub ustawia nazwę bazy danych na subskrybenta, który odbiera replikowanych danych. (Dziedziczony z Subscription).
	SubscriptionLSN
	SubscriptionType	Pobiera czy rejestracji subskrypcja jest wypychanie lub Pobierz subskrypcję. (Dziedziczony z Subscription).
	SynchronizationAgent	Pobiera wystąpienie TransSynchronizationAgent klasy, który może służyć do synchronizacji subskrypcja.
	SynchronizationAgentName	Pobiera lub ustawia nazwę zadanie agenta utworzone do synchronizacji subskrypcja. (Dziedziczony z Subscription).
	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 Subscription).
	SyncType	Pobiera lub ustawia sposób, w którym subskrypcja jest zainicjowany. (Dziedziczony z Subscription).
	UserData	Pobiera lub ustawia właściwość obiektu, który umożliwia użytkownikom dołączanie własnych danych do obiektu. (Dziedziczony z ReplicationObject).

Do góry

Metody

	Nazwa	Opis
	CheckValidCreation	Infrastruktura. (Dziedziczony z ReplicationObject).
	CheckValidDefinition	Infrastruktura. (Dziedziczony z Subscription).
	CommitPropertyChanges	Sends all the cached property change statements to the instance of Microsoft SQL Server. (Dziedziczony z ReplicationObject).
	Create	Tworzy rejestracji subskrypcja na Wydawca. (Dziedziczony z Subscription).
	Decouple	Oddzielono obiekt odwołanie replikacja z serwera. (Dziedziczony z ReplicationObject).
	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).
	InternalRefresh	Infrastruktura. (Dziedziczony z ReplicationObject).
	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()	Znaczniki subskrypcja dla następnego ponownego zainicjowania czas działa Agent dystrybucji do synchronizacji subskrypcja.
	Reinitialize(Boolean)
	Remove	Usuwa rejestracji subskrypcji przez wydawcę i obiekty replikacja subskrybent dla subskrypcja wypychana. (Dziedziczony z Subscription).
	Script	Zwraca Transact-SQL skryptu, który może służyć do tworzenia lub usuwania subskrypcja. (Dziedziczony z Subscription).
	StopSynchronizationJob	Próbuje zatrzymać uruchomione zadanie dystrybucji agenta, który Trwa synchronizowanie subskrypcja.
	SynchronizeWithJob	Uruchamia zadanie agenta do synchronizacji subskrypcja.
	ToString	(Dziedziczony z Object).

Do góry

Uwagi

Podczas konfigurowania Publisher z dystrybutor zdalny, wartości dostarczone dla wszystkich parametrów, łącznie z SynchronizationAgentProcessSecurity, są wysyłane do dystrybutora jako zwykły tekst.Należy zaszyfrować połączenie między Wydawca i jego dystrybutor zdalny przed wywoływaniem Create metoda.Aby uzyskać więcej informacji, zobacz temat Szyfrowania połączeńSQL Server.

Podczas subskrypcja należy do nie-SQL Server wydawcy, ConnectionContext właściwość jest zestaw dystrybutor zamiast Wydawca, DatabaseName właściwość jest zestaw do bazy danych dystrybucji zamiast bazy danych publikacja i PublisherName właściwość jest zestaw nazwę bez-SQL Server wydawcy.

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 a connection to the Publisher.
            ServerConnection conn = new ServerConnection(subscriberName);

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

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

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

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

                    // Define the push subscription.
                    subscription = new TransSubscription();
                    subscription.ConnectionContext = conn;
                    subscription.SubscriberName = subscriberName;
                    subscription.PublicationName = publicationName;
                    subscription.DatabaseName = publicationDbName;
                    subscription.SubscriptionDBName = subscriptionDbName;

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

                    // 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 push subscription.
                    subscription.Create();
                }
                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
            {
                conn.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 a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(subscriberName)

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

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

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

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

        ' Define the push subscription.
        subscription = New TransSubscription()
        subscription.ConnectionContext = conn
        subscription.SubscriberName = subscriberName
        subscription.PublicationName = publicationName
        subscription.DatabaseName = publicationDbName
        subscription.SubscriptionDBName = subscriptionDbName

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

        ' 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 push subscription.
        subscription.Create()
    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
    conn.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.

Udostępnij za pośrednictwem

Klasa TransSubscription

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