TransSubscription Klasse

Referenz

Definition

Namespace:: Microsoft.SqlServer.Replication

Assembly:: Microsoft.SqlServer.Rmo.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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: Object

ReplicationObject

Subscription
TransSubscription

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

Vorgehensweise: Erstellen eines Pushabonnements (RMO-Programmierung)