Bagikan melalui


TransSynchronizationAgent Kelas

Definisi

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
TransSynchronizationAgent
Atribut
Penerapan

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.