TransSynchronizationAgent Kelas

Referensi

Definisi

Ruang nama:: Microsoft.SqlServer.Replication

Rakitan:: Microsoft.SqlServer.Replication.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.

Menyediakan fungsionalitas Agen Distribusi Replikasi.

public ref class TransSynchronizationAgent : MarshalByRefObject, IDisposable, Microsoft::SqlServer::Replication::ITransSynchronizationAgent

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComSourceInterfaces(typeof(Microsoft.SqlServer.Replication.IComStatusEvent))]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Runtime.InteropServices.Guid("adeda98a-bdfc-4029-b6fb-991d6b468395")]
public class TransSynchronizationAgent : MarshalByRefObject, IDisposable, Microsoft.SqlServer.Replication.ITransSynchronizationAgent

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComSourceInterfaces(typeof(Microsoft.SqlServer.Replication.IComStatusEvent))>]
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Runtime.InteropServices.Guid("adeda98a-bdfc-4029-b6fb-991d6b468395")>]
type TransSynchronizationAgent = class
    inherit MarshalByRefObject
    interface IDisposable
    interface ITransSynchronizationAgent

Public Class TransSynchronizationAgent
Inherits MarshalByRefObject
Implements IDisposable, ITransSynchronizationAgent

Warisan: MarshalByRefObject
TransSynchronizationAgent

Atribut: ClassInterfaceAttribute ComSourceInterfacesAttribute ComVisibleAttribute GuidAttribute

Penerapan: ITransSynchronizationAgent IDisposable

Contoh

Dalam contoh berikut, Synchronize metode ini dipanggil pada instans TransSynchronizationAgent kelas yang diakses dari SynchronizationAgent properti untuk menyinkronkan langganan push.

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

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

TransSubscription subscription;

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

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

    // If the push subscription exists, start the synchronization.
    if (subscription.LoadProperties())
    {
        // Check that we have enough metadata to start the agent.
        if (subscription.SubscriberSecurity != null)
        {
            // Synchronously start the Distribution Agent for the subscription.
            subscription.SynchronizationAgent.Synchronize();
        }
        else
        {
            throw new ApplicationException("There is insufficent metadata to " +
                "synchronize the subscription. Recreate the subscription with " +
                "the agent job or supply the required agent properties at run time.");
        }
    }
    else
    {
        // Do something here if the push subscription does not exist.
        throw new ApplicationException(String.Format(
            "The subscription to '{0}' does not exist on {1}",
            publicationName, subscriberName));
    }
}
catch (Exception ex)
{
    // Implement appropriate error handling here.
    throw new ApplicationException("The subscription could not be synchronized.", ex);
}
finally
{
    conn.Disconnect();
}

' Define the server, publication, and database names.
Dim subscriberName As String = subscriberInstance
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksProductTran"
Dim subscriptionDbName As String = "AdventureWorks2012Replica"
Dim publicationDbName As String = "AdventureWorks2012"

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

Dim subscription As TransSubscription

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

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

    ' If the push subscription exists, start the synchronization.
    If subscription.LoadProperties() Then
        ' Check that we have enough metadata to start the agent.
        If Not subscription.SubscriberSecurity Is Nothing Then

            ' Synchronously start the Distribution Agent for the subscription.
            subscription.SynchronizationAgent.Synchronize()
        Else
            Throw New ApplicationException("There is insufficent metadata to " + _
             "synchronize the subscription. Recreate the subscription with " + _
             "the agent job or supply the required agent properties at run time.")
        End If
    Else
        ' Do something here if the push subscription does not exist.
        Throw New ApplicationException(String.Format( _
         "The subscription to '{0}' does not exist on {1}", _
         publicationName, subscriberName))
    End If
Catch ex As Exception
    ' Implement appropriate error handling here.
    Throw New ApplicationException("The subscription could not be synchronized.", ex)
Finally
    conn.Disconnect()
End Try

Keterangan

Kelas TransSynchronizationAgent ini mendukung kemampuan untuk menyinkronkan langganan secara terprogram ke publikasi transaksional atau rekam jepret.

Konstruktor

TransSynchronizationAgent()

Membuat instans TransSynchronizationAgent kelas .

Properti

AltSnapshotFolder	Mendapatkan atau mengatur folder rekam jepret alternatif untuk langganan.
ComErrorCollection	Mendapatkan kumpulan kesalahan yang dihasilkan oleh agen replikasi.
Distributor	Mendapatkan atau menetapkan nama instans Microsoft SQL Server yang bertindak sebagai distributor untuk langganan.
DistributorAddress	Mendapatkan atau mengatur alamat jaringan yang digunakan untuk menyambungkan ke distributor saat DistributorNetwork properti ditentukan.
DistributorEncryptedPassword	Mendapatkan atau mengatur kata sandi terenkripsi yang digunakan saat menyambungkan ke distributor dengan menggunakan Autentikasi SQL Server.
DistributorLogin	Mendapatkan atau mengatur nama login yang digunakan saat menyambungkan ke distributor dengan menggunakan Autentikasi SQL Server.
DistributorNetwork	Mendapatkan atau mengatur Net-Library klien yang digunakan saat menyambungkan ke distributor.
DistributorPassword	Mendapatkan atau mengatur kata sandi yang digunakan saat menyambungkan ke Distributor dengan menggunakan Autentikasi SQL Server.
DistributorSecurityMode	Mendapatkan atau mengatur mode keamanan yang digunakan saat menyambungkan ke distributor.
DtsPackageFileName	Mendapatkan atau mengatur nama dan jalur paket Microsoft SQL Server 2000 Data Transformation Services (DTS) yang digunakan untuk mengubah kumpulan baris perintah sebelum diterapkan ke Pelanggan.
DtsPackagePassword	Mendapatkan atau mengatur kata sandi pemilik yang digunakan untuk mengakses paket Microsoft SQL Server 2000 Data Transformation Services (DTS) yang ditentukan oleh DtsPackageFileName properti .
FileTransferType	Mendapatkan atau mengatur bagaimana file rekam jepret awal ditransfer ke Pelanggan.
HostName	Mendapatkan atau mengatur nama host yang digunakan.
LastUpdatedTime	Mendapatkan tanda waktu terakhir kali agen replikasi tersebut menyinkronkan langganan.
LoginTimeout	Mendapatkan atau mengatur jumlah detik maksimum untuk menunggu koneksi dibuat.
MaxDeliveredTransactions	Mendapatkan atau menetapkan jumlah maksimum transaksi yang diterapkan pada Pelanggan selama eksekusi agen tunggal.
Output	Mendapatkan atau mengatur nama file dan jalur file output agen.
OutputVerboseLevel	Mendapatkan atau mengatur jumlah informasi yang dicatat oleh Agen Distribusi dalam file output agen.
ProfileName	Mendapatkan atau mengatur nama profil yang digunakan oleh agen.
Publication	Mendapatkan atau mengatur nama publikasi.
Publisher	Mendapatkan atau mengatur nama instans Microsoft SQL Server yang merupakan Penerbit untuk langganan.
PublisherDatabase	Mendapatkan atau mengatur nama database publikasi.
QueryTimeout	Mendapatkan atau mengatur jumlah detik yang diizinkan untuk menyelesaikan kueri internal.
SecureDistributorEncryptedPassword	Mendapatkan atau mengatur kata sandi terenkripsi aman untuk distributor.
SecureSubscriberEncryptedPassword	Mendapatkan atau mengatur kata sandi terenkripsi yang aman untuk pelanggan.
SkipErrors	Mendapatkan atau mengatur daftar nomor kesalahan yang dipisahkan titik dua yang akan dilewati oleh agen ini.
Subscriber	Mendapatkan atau menetapkan nama instans Microsoft SQL Server yang merupakan pelanggan.
SubscriberDatabase	Mendapatkan atau mengatur nama database langganan.
SubscriberDatabasePath	Mendapatkan atau mengatur jalur database untuk pelanggan.
SubscriberDataSourceType	Mendapatkan atau mengatur jenis sumber data yang digunakan sebagai pelanggan.
SubscriberEncryptedPassword	Mendapatkan atau mengatur kata sandi terenkripsi untuk pelanggan.
SubscriberLogin	Mendapatkan atau mengatur nama login yang digunakan saat menyambungkan ke pelanggan dengan menggunakan Autentikasi SQL Server.
SubscriberPassword	Mendapatkan atau mengatur kata sandi yang digunakan saat menyambungkan ke pelanggan dengan menggunakan Autentikasi SQL Server.
SubscriberSecurityMode	Mendapatkan atau mengatur mode keamanan yang digunakan saat menyambungkan ke penerbit.
SubscriptionType	Mendapatkan atau mengatur apakah langganan adalah langganan pendorongan atau penarikan.
UndeliveredCommands	Mendapatkan jumlah perintah yang tidak terkiror.
UndeliveredTransactions	Mendapatkan jumlah transaksi yang tidak terkiror.
UseInProcLoader	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan menggunakan perintah INSERT MASSAL saat menerapkan file rekam jepret pada pelanggan.
WorkingDirectory	Mendapatkan atau mengatur direktori kerja tempat file rekam jepret diakses saat Protokol Transfer File (FTP) digunakan.

Metode

Abort()	Membatalkan TransSynchronizationAgent operasi.
Dispose()	Merilis semua sumber daya yang digunakan oleh instans TransSynchronizationAgent kelas saat ini.
Dispose(Boolean)	Merilis semua sumber daya yang TransSynchronizationAgent digunakan oleh kelas .
Finalize()	Menyelesaikan TransSynchronizationAgent.
IsSnapshotRequired()	Menyambungkan ke Distributor dan Pelanggan untuk menentukan apakah rekam jepret baru akan diterapkan selama sinkronisasi agen berikutnya.
Synchronize()	Memulai Agen Distribusi untuk menyinkronkan langganan.

Acara

ComStatus	Terjadi ketika Agen Distribusi mengembalikan informasi status Com sinkronisasi.
Status	Terjadi ketika Agen Distribusi mengembalikan informasi status sinkronisasi.

Berlaku untuk

Keamanan Thread

Kelas TransSynchronizationAgent tidak mendukung apartemen multithreaded. Anda dapat menentukan apartemen berulir tunggal dengan mendeklarasikan [STAThread] atribut pada metode yang merupakan titik masuk utama untuk aplikasi. Ini adalah default untuk aplikasi berbasis Microsoft Windows yang dibuat dengan menggunakan Microsoft Visual Studio.