Klasa TransSynchronizationAgent

Zapewnia funkcje replikacji agenta dystrybucji.

Hierarchia dziedziczenia

System.Object
  System.MarshalByRefObject
    Microsoft.SqlServer.Replication.TransSynchronizationAgent

Przestrzeń nazw:  Microsoft.SqlServer.Replication
Zestaw:  Microsoft.SqlServer.Replication (w Microsoft.SqlServer.Replication.dll)

Składnia

'Deklaracja
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
<ComVisibleAttribute(True)> _
<GuidAttribute("adeda98a-bdfc-4029-b6fb-991d6b468395")> _
<PermissionSetAttribute(SecurityAction.Demand, Name := "FullTrust")> _
Public Class TransSynchronizationAgent _
    Inherits MarshalByRefObject _
    Implements IDisposable, ITransSynchronizationAgent
'Użycie
Dim instance As TransSynchronizationAgent

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
[ComVisibleAttribute(true)]
[GuidAttribute("adeda98a-bdfc-4029-b6fb-991d6b468395")]
[PermissionSetAttribute(SecurityAction.Demand, Name = "FullTrust")]
public class TransSynchronizationAgent : MarshalByRefObject, 
    IDisposable, ITransSynchronizationAgent

[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)]
[ComVisibleAttribute(true)]
[GuidAttribute(L"adeda98a-bdfc-4029-b6fb-991d6b468395")]
[PermissionSetAttribute(SecurityAction::Demand, Name = L"FullTrust")]
public ref class TransSynchronizationAgent : public MarshalByRefObject, 
    IDisposable, ITransSynchronizationAgent

[<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)>]
[<ComVisibleAttribute(true)>]
[<GuidAttribute("adeda98a-bdfc-4029-b6fb-991d6b468395")>]
[<PermissionSetAttribute(SecurityAction.Demand, Name = "FullTrust")>]
type TransSynchronizationAgent =  
    class
        inherit MarshalByRefObject
        interface IDisposable
        interface ITransSynchronizationAgent
    end

public class TransSynchronizationAgent extends MarshalByRefObject implements IDisposable, ITransSynchronizationAgent

Typ TransSynchronizationAgent uwidacznia następujące elementy członkowskie.

Konstruktorzy

	Nazwa	Opis
	TransSynchronizationAgent	Tworzy wystąpienie TransSynchronizationAgent klasy

Do góry

Właściwości

	Nazwa	Opis
	AltSnapshotFolder	Pobiera lub ustawia folderu migawka alternatywny dla subskrypcja.
	ComErrorCollection	Pobiera kolekcja błędów generowanych przez agenta replikacja.
	Distributor	Gets or sets the name of the instance of Microsoft SQL Server that is acting as the Distributor for the subscription.
	DistributorAddress	Pobiera lub ustawia adres sieciowy, który jest używany do łączenia do dystrybutora po DistributorNetwork określona właściwość.
	DistributorEncryptedPassword	Infrastruktura.
	DistributorLogin	Pobiera lub ustawia nazwę logowania, która jest używana podczas łączenia się z dystrybutorem przy użyciu SQL Server uwierzytelniania.
	DistributorNetwork	Pobiera lub ustawia klient Net-Library używanej przy łączeniu się z dystrybutorem.
	DistributorPassword	Ustawia hasło używane przy łączeniu się z dystrybutorem za pomocą SQL Server uwierzytelniania.
	DistributorSecurityMode	Pobiera lub ustawia tryb zabezpieczeń używany przy łączeniu się z dystrybutorem.
	DtsPackageFileName	Gets or sets the name and path of a Microsoft SQL Server 2000 Data Transformation Services (DTS) package that is used to transform command rowsets before they are applied to a Subscriber.
	DtsPackagePassword	Gets or sets the owner password that used to access the Microsoft SQL Server 2000 Data Transformation Services (DTS) package specified by the DtsPackageFileName property.
	FileTransferType	Pobiera lub ustawia jak migawka początkowa pliki są przenoszone do subskrybenta.
	HostName	Infrastruktura.
	LastUpdatedTime	Pobiera czaspieczęć ostatniego czas że agent replikacja synchronizowane subskrypcja.
	LoginTimeout	Pobiera lub ustawia maksymalną liczbę sekund oczekiwania na połączeń.
	MaxDeliveredTransactions	Pobiera lub ustawia maksymalną liczbę transakcji, które są stosowane do subskrybenta podczas wykonywania jednego agenta.
	Output	Pobiera lub ustawia nazwę pliku i ścieżka pliku wyjściowego agenta.
	OutputVerboseLevel	Pobiera lub ustawia ilość informacji rejestrowanych przez agenta dystrybucji w pliku wyjściowym agenta.
	ProfileName	Pobiera lub ustawia nazwę profilu, która jest używana przez agenta.
	Publication	Pobiera lub ustawia nazwę publikacja.
	Publisher	Gets or sets the name of the instance of Microsoft SQL Server that is the Publisher for the subscription.
	PublisherDatabase	Pobiera lub ustawia nazwę baza danych publikacja.
	QueryTimeout	Pobiera lub ustawia liczbę sekund, które są dozwolone dla wewnętrznych kwerend do ukończenia.
	SecureDistributorEncryptedPassword	Infrastruktura.
	SecureSubscriberEncryptedPassword	Infrastruktura.
	SkipErrors	Pobiera lub ustawia listę numerów błędów są pomijane przez ten agent oddzielone dwukropkiem.
	Subscriber	Gets or sets the name of the instance of Microsoft SQL Server that is the Subscriber.
	SubscriberDatabase	Pobiera lub ustawia nazwę baza danych subskrypcja.
	SubscriberDatabasePath	Infrastruktura.
	SubscriberDataSourceType	Pobiera lub ustawia typ źródło danych, który jest używany jako subskrybent.
	SubscriberEncryptedPassword	Infrastruktura.
	SubscriberLogin	Pobiera lub ustawia nazwę logowania, która jest używana podczas łączenia się z subskrybenta za pomocą SQL Server uwierzytelniania.
	SubscriberPassword	Ustawia hasło używane przy łączeniu się z subskrybenta za pomocą SQL Server uwierzytelniania.
	SubscriberSecurityMode	Pobiera lub ustawia tryb zabezpieczeń, który jest używany przy łączeniu się z Wydawca.
	SubscriptionType	Pobiera lub ustawia, czy subskrypcja jest wypychanie lub Pobierz subskrypcję.
	UndeliveredCommands	Infrastruktura.
	UndeliveredTransactions	Infrastruktura.
	UseInProcLoader	Pobiera lub ustawia, czy użyć polecenia WSTAW luzem, stosując migawka plików przez subskrybenta.
	WorkingDirectory	Pobiera lub ustawia katalog roboczy, z którego migawka pliki są dostępne, gdy jest używany protokół FTP (File Transfer Protocol).

Do góry

Metody

	Nazwa	Opis
	Abort	Infrastruktura.
	CreateObjRef	(Dziedziczony z MarshalByRefObject).
	Dispose()	Infrastruktura.
	Dispose(Boolean)
	Equals	(Dziedziczony z Object).
	Finalize	Infrastruktura. (Zastępuje Object.Finalize()).
	GetHashCode	(Dziedziczony z Object).
	GetLifetimeService	(Dziedziczony z MarshalByRefObject).
	GetType	(Dziedziczony z Object).
	InitializeLifetimeService	(Dziedziczony z MarshalByRefObject).
	IsSnapshotRequired	Łączy dystrybutora i subskrybenta, aby ustalić, czy Nowa migawka zostanie zastosowany podczas następnej synchronizacji agenta.
	MemberwiseClone()	(Dziedziczony z Object).
	MemberwiseClone(Boolean)	(Dziedziczony z MarshalByRefObject).
	Synchronize	Uruchamia agenta dystrybucji do synchronizacji subskrypcja.
	ToString	(Dziedziczony z Object).

Do góry

Zdarzenia

	Nazwa	Opis
	ComStatus	Infrastruktura.
	Status	Występuje, gdy Agent dystrybucji zwraca informacje o stanie synchronizacji.

Do góry

Uwagi

TransSynchronizationAgent Klasy obsługuje możliwość programowego synchronizowania transakcyjnych subskrypcji lub publikacje migawka.

Przykłady

W poniższym przykładzie Synchronize wystąpienie wywoływana jest metoda TransSynchronizationAgent klasy, który jest dostępny z SynchronizationAgent właściwość synchronizacji subskrypcja wypychana.

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

            // 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 = "AdventureWorks2008R2Replica"
Dim publicationDbName As String = "AdventureWorks2008R2"

' 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

Bezpieczeństwo wątków

TransSynchronizationAgent Nie obsługuje klasy apartamenty wielowątkowych.Można określić jednowątkowym apartamencie oświadczając, [STAThread] atrybut metoda jest głównego punktu wejścia dla aplikacji.This is the default for Microsoft Windows-based applications that are created by using Microsoft Visual Studio.

Zobacz także

Odwołanie

Przestrzeń nazw Microsoft.SqlServer.Replication

Inne zasoby

Jak Synchronizowanie subskrypcji ściąganej (Programowanie RMO)

Jak Synchronizowanie subskrypcji wypychanej (Programowanie RMO)

Agent replikacji dystrybucji