TransSubscription Kelas

Referensi

Definisi

Ruang nama:: Microsoft.SqlServer.Replication

Rakitan:: Microsoft.SqlServer.Rmo.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mewakili langganan push ke publikasi transaksi atau rekam jepret.

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

Warisan: Object

ReplicationObject

Subscription
TransSubscription

Contoh

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

Keterangan

Saat mengonfigurasi Penerbit dengan Distributor jarak jauh, nilai yang disediakan untuk semua parameter, termasuk SynchronizationAgentProcessSecurity, dikirim ke Distributor sebagai teks biasa. Anda harus mengenkripsi koneksi antara Publisher dan Distributor jarak jauhnya sebelum memanggil Create metode . Untuk informasi selengkapnya, lihat sp_reinitsubscription (Transact-SQL).

Ketika langganan milik Penerbit non-SQL Server, ConnectionContext properti diatur ke Distributor alih-alih Publisher, DatabaseName properti diatur ke database distribusi alih-alih database publikasi, dan PublisherName properti diatur ke nama Penerbit non-SQL Server.

Keamanan Thread

Setiap anggota statis publik (Shared di Microsoft Visual Basic) jenis ini aman untuk operasi multithreaded. Setiap anggota instans tidak dijamin aman untuk utas.

Konstruktor

TransSubscription()	Membuat instans TransSubscription baru kelas.
TransSubscription(String, String, String, String, ServerConnection)	Membuat instans TransSubscription baru kelas dengan database publikasi, database, Pelanggan, dan pelanggan yang ditentukan, dan dengan koneksi yang ditentukan ke instans Microsoft SQL Server.

Properti

AgentJobId	Mendapatkan ID pekerjaan agen yang digunakan untuk menyinkronkan langganan. (Diperoleh dari Subscription)
AgentOffload	Mendapatkan atau mengatur apakah agen sinkronisasi berjalan di komputer selain yang membuat pekerjaan agen. Properti ini tidak lagi didukung untuk Distributor yang menjalankan Microsoft SQL Server 2005 dan yang lebih baru. (Diperoleh dari Subscription)
AgentOffloadServer	Mendapatkan atau mengatur nama komputer jarak jauh tempat agen berjalan saat menggunakan aktivasi agen jarak jauh. (Diperoleh dari Subscription)
AgentSchedule	Mendapatkan jadwal untuk pekerjaan agen yang digunakan untuk menyinkronkan langganan. (Diperoleh dari Subscription)
BackupInformation	Mendapatkan atau mengatur informasi yang diperlukan untuk menginisialisasi langganan dari cadangan.
CachePropertyChanges	Mendapatkan atau mengatur apakah akan menyimpan perubahan yang dilakukan pada properti replikasi atau segera menerapkannya. (Diperoleh dari ReplicationObject)
ConnectionContext	Mendapatkan atau mengatur koneksi ke instans Microsoft SQL Server. (Diperoleh dari ReplicationObject)
CreateSyncAgentByDefault	Mendapatkan atau mengatur apakah pekerjaan agen yang digunakan untuk menyinkronkan langganan dibuat secara default. (Diperoleh dari Subscription)
DatabaseName	Mendapatkan atau mengatur nama database publikasi. (Diperoleh dari Subscription)
DtsPackageLocation	Mendapatkan atau mengatur lokasi paket Microsoft SQL Server 2000 Data Transformation Services (DTS).
DtsPackageName	Mendapatkan atau menetapkan nama paket Microsoft SQL Server 2000 Data Transformation Services (DTS) yang diterapkan di Pelanggan.
DtsPackagePassword	Mengatur kata sandi yang digunakan untuk menjalankan paket Microsoft SQL Server 2000 Data Transformation Services (DTS).
EnabledForSynchronizationManager	Menentukan apakah langganan dapat disinkronkan menggunakan Microsoft Windows Synchronization Manager. (Diperoleh dari Subscription)
FullSubscription	Mendapatkan nilai yang menunjukkan apakah langganan penuh.
IsExistingObject	Mendapatkan apakah objek ada di server atau tidak. (Diperoleh dari ReplicationObject)
LoopBackDetection	Mendapatkan atau mengatur apakah Agen Distribusi mengirim transaksi yang berasal dari Pelanggan kembali ke Pelanggan atau tidak.
MemoryOptimized	Mewakili langganan push ke publikasi transaksi atau rekam jepret.
Name	Mendapatkan nama yang ditetapkan ke langganan yang sudah ada. (Diperoleh dari Subscription)
PublicationName	Mendapatkan atau menetapkan nama publikasi tempat langganan berlangganan. (Diperoleh dari Subscription)
PublisherName	Mendapatkan atau mengatur nama Publisher saat langganan milik Penerbit non-SQL Server.
SecureDtsPackagePassword	Mengatur kata sandi (sebagai objek) yang SecureString digunakan untuk menjalankan paket Microsoft SQL Server 2000 Data Transformation Services (DTS).
SqlServerName	Mendapatkan nama instans Microsoft SQL Server tempat objek ini tersambung. (Diperoleh dari ReplicationObject)
Status	Mendapatkan status langganan. (Diperoleh dari Subscription)
SubscriberCatalog	Mendapatkan atau mengatur katalog yang digunakan saat membuat koneksi ke penyedia OLE DB untuk Pelanggan non-SQL Server.
SubscriberDatasource	Nama sumber data sebagaimana dipahami oleh penyedia OLE DB untuk Pelanggan non-SQL Server.
SubscriberDatasourceType	Mengidentifikasi jenis sumber data yang merupakan Pelanggan non-SQL Server.
SubscriberLocation	Lokasi database seperti yang dipahami oleh penyedia OLE DB untuk Pelanggan non-SQL Server.
SubscriberName	Mendapatkan atau menetapkan nama instans Microsoft SQL Server yang merupakan Pelanggan. (Diperoleh dari Subscription)
SubscriberProvider	Pengidentifikasi terprogram unik (PROGID) tempat penyedia OLE DB untuk Pelanggan non-SQL Server terdaftar
SubscriberProviderString	String koneksi khusus penyedia OLE DB digunakan untuk menyambungkan ke sumber data untuk Pelanggan non-SQL Server.
SubscriberSecurity	Mendapatkan konteks keamanan yang digunakan untuk menyambungkan ke Pelanggan. (Diperoleh dari Subscription)
SubscriberType	Mendapatkan atau mengatur perilaku pembaruan untuk perubahan data di Pelanggan.
SubscriptionDBName	Mendapatkan atau mengatur nama database pada Pelanggan yang menerima data yang direplikasi. (Diperoleh dari Subscription)
SubscriptionLSN	Mendapatkan atau mengatur nomor urutan log langganan.
SubscriptionType	Mendapatkan apakah pendaftaran langganan adalah untuk langganan pendorongan atau penarikan. (Diperoleh dari Subscription)
SynchronizationAgent	Mendapatkan instans TransSynchronizationAgent kelas yang dapat digunakan untuk menyinkronkan langganan.
SynchronizationAgentName	Mendapatkan atau mengatur nama pekerjaan agen yang dibuat untuk menyinkronkan langganan. (Diperoleh dari Subscription)
SynchronizationAgentProcessSecurity	Mendapatkan konteks keamanan yang digunakan untuk menentukan akun Microsoft Windows tempat pekerjaan agen sinkronisasi berjalan untuk menyinkronkan langganan. (Diperoleh dari Subscription)
SyncType	Mendapatkan atau mengatur cara langganan diinisialisasi. (Diperoleh dari Subscription)
UserData	Mendapatkan atau mengatur properti objek yang memungkinkan pengguna melampirkan data mereka sendiri ke objek . (Diperoleh dari ReplicationObject)

Metode

CheckValidCreation()	Memeriksa pembuatan replikasi yang valid. (Diperoleh dari ReplicationObject)
CheckValidDefinition(Boolean)	Menunjukkan apakah definisi langganan valid. (Diperoleh dari Subscription)
CommitPropertyChanges()	Mengirim semua pernyataan perubahan properti yang di-cache ke instans Microsoft SQL Server. (Diperoleh dari ReplicationObject)
Create()	Membuat pendaftaran langganan di Publisher. (Diperoleh dari Subscription)
Decouple()	Memisahkan objek replikasi yang direferensikan dari server. (Diperoleh dari ReplicationObject)
DoUpdateMemoryOptimizedProperty(String)	Mewakili langganan push ke publikasi transaksi atau rekam jepret.
GetChangeCommand(StringBuilder, String, String)	Mengembalikan perintah perubahan dari replikasi. (Diperoleh dari ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)	Mengembalikan perintah buat dari replikasi. (Diperoleh dari ReplicationObject)
GetDropCommand(StringBuilder, Boolean)	Mengembalikan perintah drop dari replikasi. (Diperoleh dari ReplicationObject)
InternalRefresh(Boolean)	Memulai refresh internal dari replikasi. (Diperoleh dari ReplicationObject)
Load()	Memuat properti objek yang ada dari server. (Diperoleh dari ReplicationObject)
LoadProperties()	Memuat properti objek yang ada dari server. (Diperoleh dari ReplicationObject)
Refresh()	Memuat ulang properti objek. (Diperoleh dari ReplicationObject)
Reinitialize()	Menandai langganan untuk reinisialisasi saat berikutnya Agen Distribusi berjalan untuk menyinkronkan langganan.
Reinitialize(Boolean)	Menginisialisasi ulang langganan.
Remove()	Menghapus pendaftaran langganan di Publisher dan menghapus objek replikasi di Pelanggan untuk langganan push. (Diperoleh dari Subscription)
Script(ScriptOptions)	Mengembalikan skrip Transact-SQL yang dapat digunakan untuk membuat atau menghapus langganan. (Diperoleh dari Subscription)
StopSynchronizationJob()	Mencoba menghentikan pekerjaan Agen Distribusi yang sedang berjalan yang saat ini menyinkronkan langganan.
SynchronizeWithJob()	Memulai pekerjaan agen untuk menyinkronkan langganan.

Berlaku untuk

Lihat juga

Cara: Membuat Langganan Push (Pemrograman RMO)