Freigeben über


TransSubscription Klasse

Definition

Stellt ein Pushabonnement für eine Transaktions- oder Momentaufnahmeveröffentlichung dar.

public ref class TransSubscription sealed : Microsoft::SqlServer::Replication::Subscription
public sealed class TransSubscription : Microsoft.SqlServer.Replication.Subscription
type TransSubscription = class
    inherit Subscription
Public NotInheritable Class TransSubscription
Inherits Subscription
Vererbung

Beispiele

           // Define the Publisher, publication, and databases.
           string publicationName = "AdvWorksProductTran";
           string publisherName = publisherInstance;
           string subscriberName = subscriberInstance;
           string subscriptionDbName = "AdventureWorks2012Replica";
           string publicationDbName = "AdventureWorks2012";

           //Create a connection to the Publisher.
           ServerConnection conn = new ServerConnection(publisherName);

           // 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 = "AdventureWorks2012Replica"
Dim publicationDbName As String = "AdventureWorks2012"

'Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)

' 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

Hinweise

Beim Konfigurieren eines Verlegers mit einem Remoteverteiler werden die für alle Parameter angegebenen Werte, einschließlich SynchronizationAgentProcessSecurity, als Nur-Text an den Verteiler gesendet. Sie sollten die Verbindung zwischen dem Verleger und dem zugehörigen Remoteverteiler verschlüsseln, bevor Sie die Create-Methode aufrufen. Weitere Informationen finden Sie unter sp_reinitsubscription (Transact-SQL).

Wenn das Abonnement zu einem Nicht-SQL Server Verleger gehört, wird die ConnectionContext -Eigenschaft auf den Verteiler statt auf Verleger festgelegt, die DatabaseName -Eigenschaft auf die Verteilungsdatenbank anstelle der Veröffentlichungsdatenbank und die PublisherName -Eigenschaft auf den Namen des Nicht-SQL Server Verlegers festgelegt.

Threadsicherheit

Alle öffentlichen statischen (Shared in Microsoft Visual Basic) Member dieses Typs sind für Multithreadvorgänge sicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Konstruktoren

TransSubscription()

Erstellt eine neue Instanz der TransSubscription-Klasse.

TransSubscription(String, String, String, String, ServerConnection)

Erstellt eine neue Instanz der TransSubscription -Klasse mit der angegebenen Veröffentlichungs-, Datenbank-, Abonnenten- und Abonnentendatenbank und mit der angegebenen Verbindung mit der Instanz von Microsoft SQL Server.

Eigenschaften

AgentJobId

Ruft die ID des Agentauftrags zum Synchronisieren des Abonnements ab.

(Geerbt von Subscription)
AgentOffload

Ruft ab oder legt fest, ob der Synchronisierungs-Agent auf einem anderen Computer als dem ausgeführt wird, mit dem der Agentauftrag erstellt wurde. Diese Eigenschaft wird für Verteiler, die Microsoft SQL Server 2005 und höher ausführen, nicht mehr unterstützt.

(Geerbt von Subscription)
AgentOffloadServer

Ruft den Namen des Remotecomputers ab, auf dem der Agent bei Aktivierung des Remote-Agents ausgeführt wird, oder legt ihn fest.

(Geerbt von Subscription)
AgentSchedule

Ruft den Zeitplan für den Agentauftrag zum Synchronisieren des Abonnements ab.

(Geerbt von Subscription)
BackupInformation

Ruft Informationen ab, die benötigt werden, um ein Abonnement aus einer Sicherung zu initialisieren, oder legt sie fest.

CachePropertyChanges

Ruft ab oder legt fest, ob Änderungen an den Replikationseigenschaften zwischengespeichert oder sofort angewendet werden sollen.

(Geerbt von ReplicationObject)
ConnectionContext

Ruft die Verbindung mit einer Instanz von Microsoft SQL Server ab oder legt sie fest.

(Geerbt von ReplicationObject)
CreateSyncAgentByDefault

Ruft ab oder legt fest, ob der Agentauftrag zum Synchronisieren des Abonnements standardmäßig erstellt wird.

(Geerbt von Subscription)
DatabaseName

Ruft den Namen der Veröffentlichungsdatenbank ab oder legt ihn fest.

(Geerbt von Subscription)
DtsPackageLocation

Ruft den Speicherort des Microsoft SQL Server 2000 Data Transformation Services-Pakets (DTS) ab oder legt diese fest.

DtsPackageName

Ruft den Namen des Microsoft SQL Server 2000 Data Transformation Services(DTS)-Pakets ab, das auf den Abonnenten angewendet wird, oder legt diesen fest.

DtsPackagePassword

Legt das Kennwort fest, das zum Ausführen des Microsoft SQL Server 2000 Data Transformation Services(DTS)-Pakets verwendet wird.

EnabledForSynchronizationManager

Gibt an, ob das Abonnement mit dem Microsoft Windows-Synchronisierungs-Manager synchronisiert werden kann.

(Geerbt von Subscription)
FullSubscription

Ruft einen Wert ab, der angibt, ob das Abonnement vollständig ist.

IsExistingObject

Ruft ab, ob das Objekt auf dem Server vorhanden ist.

(Geerbt von ReplicationObject)
LoopBackDetection

Ruft ab oder legt fest, ob der Verteilungs-Agent Transaktionen des Abonnenten zurück an den Abonnenten sendet oder nicht.

MemoryOptimized

Stellt ein Pushabonnement für eine Transaktions- oder Momentaufnahmeveröffentlichung dar.

Name

Ruft den Namen ab, der einem vorhandenen Abonnement zugewiesenen ist.

(Geerbt von Subscription)
PublicationName

Ruft den Namen der Veröffentlichung ab, die das Abonnement abonniert, oder legt diesen fest.

(Geerbt von Subscription)
PublisherName

Ruft den Namen des Verlegers ab, wenn das Abonnement zu einem Nicht-SQL Server Verleger gehört, oder legt diesen fest.

SecureDtsPackagePassword

Legt das Kennwort (als SecureString Objekt) fest, das zum Ausführen des Microsoft SQL Server 2000 Data Transformation Services(DTS)-Pakets verwendet wird.

SqlServerName

Ruft den Namen der Microsoft SQL Server-Instanz ab, mit der dieses Objekt verbunden ist.

(Geerbt von ReplicationObject)
Status

Ruft den Status des Abonnements ab.

(Geerbt von Subscription)
SubscriberCatalog

Ruft den Katalog ab, der beim Herstellen einer Verbindung mit dem OLE DB-Anbieter für einen Nicht-SQL Server Abonnenten verwendet wird, oder legt ihn fest.

SubscriberDatasource

Name der Datenquelle, wie er vom OLE DB-Anbieter für einen nicht SQL Server Abonnenten verstanden wird.

SubscriberDatasourceType

Gibt den Typ der Datenquelle an, bei der es sich um einen nicht SQL Server Abonnenten handelt.

SubscriberLocation

Speicherort der Datenbank, wie er vom OLE DB-Anbieter für den nicht SQL Server Abonnenten verstanden wird.

SubscriberName

Ruft den Namen der Microsoft SQL Server-Instanz ab, die der Abonnent ist, oder legt diesen fest.

(Geerbt von Subscription)
SubscriberProvider

Eindeutiger programmgesteuerter Bezeichner (PROGID), mit dem der OLE DB-Anbieter für den nicht SQL Server Abonnenten registriert ist

SubscriberProviderString

Die anbieterspezifische OLE DB-Verbindungszeichenfolge wird verwendet, um eine Verbindung mit der Datenquelle für Nicht-SQL Server-Abonnenten herzustellen.

SubscriberSecurity

Ruft den Sicherheitskontext ab, mit dem eine Verbindung mit dem Abonnenten hergestellt wird.

(Geerbt von Subscription)
SubscriberType

Ruft das Aktualisierungsverhalten für Datenänderungen beim Abonnenten ab oder legt es fest.

SubscriptionDBName

Ruft den Namen der Datenbank für den Abonnenten ab, der die replizierten Daten empfängt, oder legt ihn fest.

(Geerbt von Subscription)
SubscriptionLSN

Ruft die Protokollfolgenummer des Abonnements ab oder legt sie fest.

SubscriptionType

Ruft ab, ob die Abonnementregistrierung für ein Push- oder Pullabonnement vorgesehen ist.

(Geerbt von Subscription)
SynchronizationAgent

Ruft eine Instanz der TransSynchronizationAgent-Klasse ab, die verwendet werden kann, um das Abonnement zu synchronisieren.

SynchronizationAgentName

Ruft den Namen des Agentauftrags ab, der zum Synchronisieren des Abonnements erstellt wurde, oder legt ihn fest.

(Geerbt von Subscription)
SynchronizationAgentProcessSecurity

Ruft den Sicherheitskontext ab, der zum Angeben des Microsoft Windows-Kontos verwendet wird, unter dem der Synchronisierungs-Agent-Auftrag ausgeführt wird, um das Abonnement zu synchronisieren.

(Geerbt von Subscription)
SyncType

Ruft die Art ab, in der das Abonnement initialisiert wird, oder legt sie fest.

(Geerbt von Subscription)
UserData

Ruft eine Objekteigenschaft ab, die es Benutzern ermöglicht, ihre eigenen Daten an das Objekt anzufügen, oder legt sie fest.

(Geerbt von ReplicationObject)

Methoden

CheckValidCreation()

Überprüft, ob die Replikationserstellung gültig ist.

(Geerbt von ReplicationObject)
CheckValidDefinition(Boolean)

Gibt an, ob die Abonnementdefinition gültig ist.

(Geerbt von Subscription)
CommitPropertyChanges()

Sendet alle zwischengespeicherten Eigenschaftsänderungsanweisungen an die Instanz von Microsoft SQL Server.

(Geerbt von ReplicationObject)
Create()

Erstellt die Abonnementregistrierung beim Verleger.

(Geerbt von Subscription)
Decouple()

Entkoppelt das Replikationsobjekt, auf das verwiesen wird, vom Server.

(Geerbt von ReplicationObject)
DoUpdateMemoryOptimizedProperty(String)

Stellt ein Pushabonnement für eine Transaktions- oder Momentaufnahmeveröffentlichung dar.

GetChangeCommand(StringBuilder, String, String)

Gibt den Änderungsbefehl von der Replikation zurück.

(Geerbt von ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)

Gibt den Erstellungsbefehl von der Replikation zurück.

(Geerbt von ReplicationObject)
GetDropCommand(StringBuilder, Boolean)

Gibt den Löschbefehl von der Replikation zurück.

(Geerbt von ReplicationObject)
InternalRefresh(Boolean)

Initiiert eine interne Aktualisierung von der Replikation.

(Geerbt von ReplicationObject)
Load()

Lädt die Eigenschaften eines vorhandenen Objekts vom Server.

(Geerbt von ReplicationObject)
LoadProperties()

Lädt die Eigenschaften eines vorhandenen Objekts vom Server.

(Geerbt von ReplicationObject)
Refresh()

Lädt die Eigenschaften des Objekts erneut.

(Geerbt von ReplicationObject)
Reinitialize()

Kennzeichnet das Abonnement für die erneute Initialisierung bei der nächsten Ausführung des Verteilungs-Agents, um das Abonnement zu synchronisieren.

Reinitialize(Boolean)

Initialisiert das Abonnement erneut.

Remove()

Löscht die Abonnementregistrierung beim Verleger und entfernt Replikationsobjekte beim Abonnenten für ein Pushabonnement.

(Geerbt von Subscription)
Script(ScriptOptions)

Gibt ein Transact-SQL-Skript zurück, das zum Erstellen oder Löschen des Abonnements verwendet werden kann.

(Geerbt von Subscription)
StopSynchronizationJob()

Versucht, einen ausgeführten Verteilungs-Agentauftrag zu beenden, der das Abonnement gerade synchronisiert.

SynchronizeWithJob()

Startet den Agent-Auftrag zur Synchronisierung des Abonnements.

Gilt für:

Weitere Informationen