Klasa TransPublication

Reprezentuje transakcyjnych publikacja.

Hierarchia dziedziczenia

System.Object
  Microsoft.SqlServer.Replication.ReplicationObject
    Microsoft.SqlServer.Replication.Publication
      Microsoft.SqlServer.Replication.TransPublication

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

Składnia

'Deklaracja
Public NotInheritable Class TransPublication _
    Inherits Publication
'Użycie
Dim instance As TransPublication

public sealed class TransPublication : Publication

public ref class TransPublication sealed : public Publication

[<SealedAttribute>]
type TransPublication =  
    class
        inherit Publication
    end

public final class TransPublication extends Publication

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

Konstruktorzy

	Nazwa	Opis
	TransPublication()	Tworzy nowe wystąpienie TransPublication klasy
	TransPublication(String, String, ServerConnection)	Tworzy nowe wystąpienie TransPublication klasy z wymaganych właściwości.
	TransPublication(String, String, ServerConnection, Boolean)	Tworzy nowe wystąpienie TransPublication klasy z wymaganych właściwości i wskazuje, czy zadanie agenta migawki publikacja jest tworzona.

Do góry

Właściwości

	Nazwa	Opis
	AltSnapshotFolder	Pobiera lub Ustawia lokalizację pliku migawka alternatywny dla publikacja. (Dziedziczony z Publication).
	Attributes	Pobiera lub ustawia atrybuty publikacja. (Dziedziczony z Publication).
	CachePropertyChanges	Pobiera lub ustawia, czy zmiany właściwości replikacja w pamięci podręcznej, czy stosuje je niezwłocznie. (Dziedziczony z ReplicationObject).
	CompatibilityLevel	Gets or sets the earliest version of Microsoft SQL Server running on the Subscribers that the referenced publication can support. (Dziedziczony z Publication).
	ConflictPolicy	Pobiera lub ustawia zasady konfliktu publikacji, które obsługują subskrypcji aktualizacji.
	ConflictRetention	Pobiera lub ustawia liczbę dni, które wiersze danych konfliktu są zachowywane w tabelach konfliktu. (Dziedziczony z Publication).
	ConnectionContext	Gets or sets the connection to an instance of Microsoft SQL Server. (Dziedziczony z ReplicationObject).
	ContinueOnConflict	Określa, czy Agent dystrybucji kontynuuje przetwarzanie zmian po wykryciu konflikt.
	CreateSnapshotAgentByDefault	Pobiera lub ustawia Jeśli zadanie agenta migawki jest automatycznie dodawane podczas tworzenia publikacja. (Dziedziczony z Publication).
	DatabaseName	Pobiera lub ustawia nazwę baza danych publikacja. (Dziedziczony z Publication).
	Description	Pobiera lub ustawia opis tekstowy publikacja. (Dziedziczony z Publication).
	FtpAddress	Pobiera lub ustawia adres komputera serwera File Transfer Protocol (FTP) dla publikacji, zezwalające na zainicjowanie subskrypcja za pośrednictwem FTP. (Dziedziczony z Publication).
	FtpLogin	Pobiera lub ustawia logowania, używany do łączenia z serwerem File Transfer Protocol (FTP) dla publikacji, które umożliwiają inicjowanie subskrypcja za pośrednictwem FTP. (Dziedziczony z Publication).
	FtpPassword	Ustawia hasło logowania, używany do łączenia z serwerem File Transfer Protocol (FTP) dla publikacji, które umożliwiają inicjowanie subskrypcja za pośrednictwem FTP. (Dziedziczony z Publication).
	FtpPort	Pobiera lub ustawia port komputera serwera File Transfer Protocol (FTP) dla publikacji, zezwalające na zainicjowanie subskrypcja za pośrednictwem FTP. (Dziedziczony z Publication).
	FtpSubdirectory	Pobiera lub ustawia podkatalogu na komputerze serwera File Transfer Protocol (FTP) dla publikacji, zezwalające na zainicjowanie subskrypcja za pośrednictwem FTP. (Dziedziczony z Publication).
	HasSubscription	Pobiera się, czy publikacja ma jedną lub więcej subskrypcji. (Dziedziczony z Publication).
	IsExistingObject	Pobiera się, czy obiekt istnieje na serwerze. (Dziedziczony z ReplicationObject).
	Name	Pobiera lub ustawia nazwę publikacja. (Dziedziczony z Publication).
	PeerConflictDetectionEnabled	Pobiera czy zostało włączone wykrywanie konfliktów peer-to-peer, za pomocą SetPeerConflictDetection.
	PeerOriginatorID	Pobiera identyfikator węzła w topologii peer-to-peer; Ten identyfikator jest używany do wykrywanie konfliktów, jeśli PeerConflictDetectionEnabled jest zestaw do true.
	PostSnapshotScript	Pobiera lub ustawia nazwę i pełną ścieżka Transact-SQL pliku skryptu, który jest wykonywany po migawka początkowa jest stosowany do subskrybenta. (Dziedziczony z Publication).
	PreSnapshotScript	Pobiera lub ustawia nazwę i pełną ścieżka Transact-SQL pliku skryptu, który jest wykonywany przed migawka początkowa jest stosowany do subskrybenta. (Dziedziczony z Publication).
	PubId	Pobiera wartość, która jednoznacznie identyfikuje publikacja. (Dziedziczony z Publication).
	PublisherName	Pobiera lub ustawia nazwę z innych niż - SQL Server Wydawca.
	QueueType	Pobiera lub ustawia typ kolejki dla publikacji, które umożliwiają kolejce subskrypcje aktualizacji.
	ReplicateDdl	Pobiera lub ustawia opcji replikacja języka (DDL), które określają, jeśli DDL zmiany są replikowane w definicja danych. (Dziedziczony z Publication).
	RetentionPeriod	Pobiera lub ustawia czas wygaśnięcia subskrypcja podczas subskrypcja nie został zsynchronizowany z publikacja. (Dziedziczony z Publication).
	SecureFtpPassword	Ustawia hasło (jako SecureString obiektu) podczas logowania używane do łączenia z serwerem File Transfer Protocol (FTP) dla publikacji, które umożliwiają inicjowanie subskrypcja za pośrednictwem FTP. (Dziedziczony z Publication).
	SnapshotAgentExists	Pobiera Jeśli SQL Server zadanie agenta istnieje do generowania migawka początkowa dla publikacja. (Dziedziczony z Publication).
	SnapshotAvailable	Pobiera się, czy pliki migawka dla tej publikacja są dostępne do użycia.
	SnapshotGenerationAgentProcessSecurity	Pobiera obiekt, który ustawia konto systemu Windows używane do uruchamiania zadanie agenta migawki. (Dziedziczony z Publication).
	SnapshotGenerationAgentPublisherSecurity	Pobiera kontekst zabezpieczeń, używana przez agenta migawki, aby połączyć Wydawca. (Dziedziczony z Publication).
	SnapshotJobId	Pobiera identyfikator zadanie agenta migawki dla bieżącej publikacja. (Dziedziczony z Publication).
	SnapshotMethod	Pobiera lub ustawia format pliku danych migawka początkowa. (Dziedziczony z Publication).
	SnapshotSchedule	Pobiera obiekt, który ustawia harmonogramu dla agenta migawki dla bieżącej publikacja. (Dziedziczony z Publication).
	SqlServerName	Gets the name of the Microsoft SQL Server instance to which this object is connected. (Dziedziczony z ReplicationObject).
	Status	Pobiera lub ustawia stan publikacja. (Dziedziczony z Publication).
	TransArticles	Reprezentuje artykuły w publikacja.
	TransSubscriptions	Reprezentuje subskrypcje do publikacja.
	Type	Pobiera lub ustawia typ publikacja. (Dziedziczony z Publication).
	UserData	Pobiera lub ustawia właściwość obiektu, który umożliwia użytkownikom dołączanie własnych danych do obiektu. (Dziedziczony z ReplicationObject).

Do góry

Metody

	Nazwa	Opis
	BrowseSnapshotFolder	Zwraca pełną ścieżka lokalizacji, gdzie migawka pliki zostały wygenerowane określonych subskrypcja.
	CheckValidCreation	Infrastruktura. (Dziedziczony z ReplicationObject).
	CheckValidDefinition	Infrastruktura. (Dziedziczony z Publication).
	CommitPropertyChanges	Sends all the cached property change statements to the instance of Microsoft SQL Server. (Dziedziczony z ReplicationObject).
	CopySnapshot	Kopiuje najnowszych plików migawka subskrypcja określony folder obiekt docelowy.
	Create	Tworzy publikacja. (Dziedziczony z Publication).
	CreateSnapshotAgent	Tworzy SQL Server zadanie agenta, używanego do generowania migawka początkowa w publikacja tego zadanie nie istnieje. (Dziedziczony z Publication).
	Decouple	Oddzielono obiekt odwołanie replikacja z serwera. (Dziedziczony z ReplicationObject).
	EnumArticles	Zwraca artykułów w publikacja. (Dziedziczony z Publication).
	EnumPublicationAccesses	Zwraca logowania, do których mają dostęp do Wydawca. (Dziedziczony z Publication).
	EnumSubscriptions	Zwraca subskrypcje, które subskrybować publikacja. (Dziedziczony z Publication).
	Equals	(Dziedziczony z Object).
	Finalize	(Dziedziczony z Object).
	GetChangeCommand	Infrastruktura. (Dziedziczony z ReplicationObject).
	GetCreateCommand	Infrastruktura. (Dziedziczony z ReplicationObject).
	GetDropCommand	Infrastruktura. (Dziedziczony z ReplicationObject).
	GetHashCode	(Dziedziczony z Object).
	GetType	(Dziedziczony z Object).
	GrantPublicationAccess	Dodaje określony login do lista dostępu do publikacja (PAL). (Dziedziczony z Publication).
	InternalRefresh	Infrastruktura. (Dziedziczony z ReplicationObject).
	Load	Ładuje właściwości istniejącego obiektu z serwera. (Dziedziczony z ReplicationObject).
	LoadProperties	Ładuje właściwości istniejącego obiektu z serwera. (Dziedziczony z ReplicationObject).
	MakePullSubscriptionWellKnown	Rejestry subskrypcja wciągana przez wydawcę.
	MemberwiseClone	(Dziedziczony z Object).
	PostTracerToken	Ogłoszenia w Dzienniku Wydawca, aby rozpocząć proces określania token śledzący opóźnienie.
	Refresh	Ponownie ładuje właściwości obiektu. (Dziedziczony z ReplicationObject).
	RefreshSubscriptions	Aktualizuje wszystkie subskrypcje w publikacja, aby uwzględnić wszystkie nowo dodane artykuły.
	ReinitializeAllSubscriptions()	Oznacza wszystkie subskrypcje w publikacja do ponownego inicjowania.
	ReinitializeAllSubscriptions(Boolean)	Oznacza wszystkie subskrypcje w publikacja do ponownego zainicjowania z opcją unieważnianie istniejących migawka.
	Remove()	Usuwa istniejącą publikacja. (Dziedziczony z Publication).
	Remove(Boolean)	Usuwa istniejącej publikacja, nawet jeśli dystrybutor, nie jest dostępny. (Dziedziczony z Publication).
	RemovePullSubscription	Usuwa rejestracji dla subskrypcja wciągana przez wydawcę.
	ReplicateUserDefinedScript	Replikuje wykonanie skryptu użytkownika abonentów określonego publikacja. (Dziedziczony z Publication).
	RevokePublicationAccess	Usuwa określony login z lista dostępu do publikacja (PAL). (Dziedziczony z Publication).
	Script	Generuje Transact-SQL skryptu, który może służyć do odtworzenia publikacja określone przez opcje skryptu. (Dziedziczony z Publication).
	SetPeerConflictDetection	Włącza lub wyłącza wykrywanie konfliktów dla węzła w topologii peer-to-peer.
	StartSnapshotGenerationAgentJob	Uruchamia zadanie, który generuje migawka początkowa w publikacja. (Dziedziczony z Publication).
	StopSnapshotGenerationAgentJob	Próbuje zatrzymać uruchomione zadanie agenta migawki. (Dziedziczony z Publication).
	ToString	(Dziedziczony z Object).
	ValidatePublication	Wywołuje sprawdzanie poprawności publikacja wewnętrznych dla wszystkich subskrypcji.
	ValidateSubscriptions	Wywołuje sprawdzanie poprawności publikacja wbudowany określonej subskrypcja.

Do góry

Uwagi

Ten obszar nazw, klasy lub element członkowski jest obsługiwany tylko w wersja 2.0.NET Framework.

Bezpieczeństwo wątków

Wszystkie publiczne statyczne (Shared w Microsoft języka Visual Basic) elementy tego typu są bezpieczne dla operacji wielowątkowe.Nie ma gwarancji, że elementy członkowskie wystąpień będą bezpieczne dla wątków.

Przykłady

W tym przykładzie tworzony transakcyjnych publikacja.

         // Set the Publisher, publication database, and publication names.
            string publicationName = "AdvWorksProductTran";
            string publicationDbName = "AdventureWorks2008R2";
            string publisherName = publisherInstance;

            ReplicationDatabase publicationDb;
            TransPublication publication;

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


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

                // Enable the AdventureWorks database for transactional publishing.
                publicationDb = new ReplicationDatabase(publicationDbName, conn);

                // If the database exists and is not already enabled, 
                // enable it for transactional publishing.
                if (publicationDb.LoadProperties())
                {
                    if (!publicationDb.EnabledTransPublishing)
                    {
                        publicationDb.EnabledTransPublishing = true;
                    }

                    // If the Log Reader Agent does not exist, create it.
                    if (!publicationDb.LogReaderAgentExists)
                    {
                        // Specify the Windows account under which the agent job runs.
                        // This account will be used for the local connection to the 
                        // Distributor and all agent connections that use Windows Authentication.
                        publicationDb.LogReaderAgentProcessSecurity.Login = winLogin;
                        publicationDb.LogReaderAgentProcessSecurity.Password = winPassword;

                        // Explicitly set authentication mode for the Publisher connection
                        // to the default value of Windows Authentication.
                        publicationDb.LogReaderAgentPublisherSecurity.WindowsAuthentication = true;

                        // Create the Log Reader Agent job.
                        publicationDb.CreateLogReaderAgent();
                    }
                }
                else
                {
                    throw new ApplicationException(String.Format(
                        "The {0} database does not exist at {1}.",
                        publicationDb, publisherName));
                }

                // Set the required properties for the transactional publication.
                publication = new TransPublication();
                publication.ConnectionContext = conn;
                publication.Name = publicationName;
                publication.DatabaseName = publicationDbName;

                // Specify a transactional publication (the default).
                publication.Type = PublicationType.Transactional;

                // Activate the publication so that we can add subscriptions.
                publication.Status = State.Active;

                // Enable push and pull subscriptions and independent Distribition Agents.
                publication.Attributes |= PublicationAttributes.AllowPull;
                publication.Attributes |= PublicationAttributes.AllowPush;
                publication.Attributes |= PublicationAttributes.IndependentAgent;

                // Specify the Windows account under which the Snapshot Agent job runs.
                // This account will be used for the local connection to the 
                // Distributor and all agent connections that use Windows Authentication.
                publication.SnapshotGenerationAgentProcessSecurity.Login = winLogin;
                publication.SnapshotGenerationAgentProcessSecurity.Password = winPassword;

                // Explicitly set the security mode for the Publisher connection
                // Windows Authentication (the default).
                publication.SnapshotGenerationAgentPublisherSecurity.WindowsAuthentication = true;

                if (!publication.IsExistingObject)
                {
                    // Create the transactional publication.
                    publication.Create();

                    // Create a Snapshot Agent job for the publication.
                    publication.CreateSnapshotAgent();
                }
                else
                {
                    throw new ApplicationException(String.Format(
                        "The {0} publication already exists.", publicationName));
                }
            }

            catch (Exception ex)
            {
                // Implement custom application error handling here.
                throw new ApplicationException(String.Format(
                    "The publication {0} could not be created.", publicationName), ex);
            }
            finally
            {
                conn.Disconnect();
            }

' Set the Publisher, publication database, and publication names.
Dim publicationName As String = "AdvWorksProductTran"
Dim publicationDbName As String = "AdventureWorks2008R2"
Dim publisherName As String = publisherInstance

Dim publicationDb As ReplicationDatabase
Dim publication As TransPublication

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

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

    ' Enable the AdventureWorks database for transactional publishing.
    publicationDb = New ReplicationDatabase(publicationDbName, conn)

    ' If the database exists and is not already enabled, 
    ' enable it for transactional publishing.
    If publicationDb.LoadProperties() Then
        If Not publicationDb.EnabledTransPublishing Then
            publicationDb.EnabledTransPublishing = True
        End If

        ' If the Log Reader Agent does not exist, create it.
        If Not publicationDb.LogReaderAgentExists Then
            ' Specify the Windows account under which the agent job runs.
            ' This account will be used for the local connection to the 
            ' Distributor and all agent connections that use Windows Authentication.
            publicationDb.LogReaderAgentProcessSecurity.Login = winLogin
            publicationDb.LogReaderAgentProcessSecurity.Password = winPassword

            ' Explicitly set authentication mode for the Publisher connection
            ' to the default value of Windows Authentication.
            publicationDb.LogReaderAgentPublisherSecurity.WindowsAuthentication = True

            ' Create the Log Reader Agent job.
            publicationDb.CreateLogReaderAgent()
        End If
    Else
        Throw New ApplicationException(String.Format( _
         "The {0} database does not exist at {1}.", _
         publicationDb, publisherName))
    End If

    ' Set the required properties for the transactional publication.
    publication = New TransPublication()
    publication.ConnectionContext = conn
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName

    ' Specify a transactional publication (the default).
    publication.Type = PublicationType.Transactional

    'Enable push and pull subscriptions and independent Distribition Agents.
    publication.Attributes = _
    publication.Attributes Or PublicationAttributes.AllowPull
    publication.Attributes = _
    publication.Attributes Or PublicationAttributes.AllowPush
    publication.Attributes = _
    publication.Attributes Or PublicationAttributes.IndependentAgent

    ' Activate the publication so that we can add subscriptions.
    publication.Status = State.Active

    ' Specify the Windows account under which the Snapshot Agent job runs.
    ' This account will be used for the local connection to the 
    ' Distributor and all agent connections that use Windows Authentication.
    publication.SnapshotGenerationAgentProcessSecurity.Login = winLogin
    publication.SnapshotGenerationAgentProcessSecurity.Password = winPassword

    ' Explicitly set the security mode for the Publisher connection
    ' Windows Authentication (the default).
    publication.SnapshotGenerationAgentPublisherSecurity.WindowsAuthentication = True

    If Not publication.IsExistingObject Then
        ' Create the transactional publication.
        publication.Create()

        ' Create a Snapshot Agent job for the publication.
        publication.CreateSnapshotAgent()
    Else
        Throw New ApplicationException(String.Format( _
            "The {0} publication already exists.", publicationName))
    End If
Catch ex As Exception
    ' Implement custom application error handling here.
    Throw New ApplicationException(String.Format( _
        "The publication {0} could not be created.", publicationName), ex)
Finally
    conn.Disconnect()
End Try

W tym przykładzie usuwa transakcyjnych publikacja.

            // Define the Publisher, publication database, 
            // and publication names.
            string publisherName = publisherInstance;
            string publicationName = "AdvWorksProductTran";
            string publicationDbName = "AdventureWorks2008R2";

            TransPublication publication;
            ReplicationDatabase publicationDb;

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

            try
            {
                conn.Connect();

                // Set the required properties for the transactional publication.
                publication = new TransPublication();
                publication.ConnectionContext = conn;
                publication.Name = publicationName;
                publication.DatabaseName = publicationDbName;

                // Delete the publication, if it exists and has no subscriptions.
                if (publication.LoadProperties() && !publication.HasSubscription)
                {
                    publication.Remove();
                }
                else
                {
                    // Do something here if the publication does not exist
                    // or has subscriptions.
                    throw new ApplicationException(String.Format(
                        "The publication {0} could not be deleted. " +
                        "Ensure that the publication exists and that all " +
                        "subscriptions have been deleted.",
                        publicationName, publisherName));
                }

                // If no other transactional publications exists,
                // disable publishing on the database.
                publicationDb = new ReplicationDatabase(publicationDbName, conn);
                if (publicationDb.LoadProperties())
                {
                    if (publicationDb.TransPublications.Count == 0)
                    {
                        publicationDb.EnabledTransPublishing = false;
                    }
                }
                else
                {
                    // Do something here if the database does not exist.
                    throw new ApplicationException(String.Format(
                        "The database {0} does not exist on {1}.",
                        publicationDbName, publisherName));
                }
            }
            catch (Exception ex)
            {
                // Implement application error handling here.
                throw new ApplicationException(String.Format(
                    "The publication {0} could not be deleted.",
                    publicationName), ex);
            }
            finally
            {
                conn.Disconnect();
            }

' Define the Publisher, publication database, 
' and publication names.
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksProductTran"
Dim publicationDbName As String = "AdventureWorks2008R2"

Dim publication As TransPublication
Dim publicationDb As ReplicationDatabase

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

Try
    conn.Connect()

    ' Set the required properties for the transactional publication.
    publication = New TransPublication()
    publication.ConnectionContext = conn
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName

    ' Delete the publication, if it exists and has no subscriptions.
    If publication.LoadProperties() And Not publication.HasSubscription Then
        publication.Remove()
    Else
        ' Do something here if the publication does not exist
        ' or has subscriptions.
        Throw New ApplicationException(String.Format( _
         "The publication {0} could not be deleted. " + _
         "Ensure that the publication exists and that all " + _
         "subscriptions have been deleted.", _
         publicationName, publisherName))
    End If

    ' If no other transactional publications exists,
    ' disable publishing on the database.
    publicationDb = New ReplicationDatabase(publicationDbName, conn)
    If publicationDb.LoadProperties() Then
        If publicationDb.TransPublications.Count = 0 Then
            publicationDb.EnabledTransPublishing = False
        End If
    Else
        ' Do something here if the database does not exist.
        Throw New ApplicationException(String.Format( _
         "The database {0} does not exist on {1}.", _
         publicationDbName, publisherName))
    End If
Catch ex As Exception
    ' Implement application error handling here.
    Throw New ApplicationException(String.Format( _
     "The publication {0} could not be deleted.", _
     publicationName), ex)
Finally
    conn.Disconnect()
End Try

Bezpieczeństwo wątków

Wszystkie publiczne statyczny (Shared w języku Visual Basic) elementy członkowskie tego typu są bezpieczne dla wątków. Nie ma gwarancji, że elementy członkowskie wystąpień będą bezpieczne dla wątków.

Zobacz także

Odwołanie

Przestrzeń nazw Microsoft.SqlServer.Replication

Inne zasoby

Jak Tworzenie publikacji (Programowanie RMO)