Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase TransPublication

 

Representa una publicación transaccional.

Espacio de nombres:   Microsoft.SqlServer.Replication
Ensamblado:  Microsoft.SqlServer.Rmo (en Microsoft.SqlServer.Rmo.dll)


public sealed class TransPublication : Publication

NombreDescripción
System_CAPS_pubmethodTransPublication()

Crea una instancia de la clase TransPublication.

System_CAPS_pubmethodTransPublication(String, String, ServerConnection)

Crea una instancia de la clase TransPublication con las propiedades requeridas.

System_CAPS_pubmethodTransPublication(String, String, ServerConnection, Boolean)

Crea una instancia de la clase TransPublication con las propiedades requeridas e indica si se crea el trabajo del Agente de instantáneas para la publicación.

NombreDescripción
System_CAPS_pubpropertyAltSnapshotFolder

Obtiene o establece la ubicación del archivo de instantáneas alternativo para una publicación. (Heredado de Publication).

System_CAPS_pubpropertyAttributes

Obtiene o establece los atributos de la publicación.(Heredado de Publication).

System_CAPS_pubpropertyCachePropertyChanges

Obtiene o establece si los cambios realizados en las propiedades de replicación se almacenan en memoria caché o se aplican inmediatamente.(Heredado de ReplicationObject).

System_CAPS_pubpropertyCompatibilityLevel

Obtiene o establece la versión anterior de Microsoft SQL Server que se ejecuta en los suscriptores con los que es compatible la publicación a la que se hace referencia.(Heredado de Publication).

System_CAPS_pubpropertyConflictPolicy

Obtiene o establece la directiva de conflictos para las publicaciones con las que son compatibles las suscripciones de actualización.

System_CAPS_pubpropertyConflictRetention

Obtiene o establece el número de días que las filas de datos de conflicto se conservan en las tablas de conflictos.(Heredado de Publication).

System_CAPS_pubpropertyConnectionContext

Obtiene o establece la conexión a una instancia de Microsoft SQL Server.(Heredado de ReplicationObject).

System_CAPS_pubpropertyContinueOnConflict

Determina si el Agente de distribución continúa procesando los cambios después de la detección de un conflicto.

System_CAPS_pubpropertyCreateSnapshotAgentByDefault

Obtiene o establece si automáticamente se agrega el trabajo del Agente de instantáneas cuando se crea la publicación.(Heredado de Publication).

System_CAPS_pubpropertyDatabaseName

Obtiene o establece el nombre de la base de datos de publicación. (Heredado de Publication).

System_CAPS_pubpropertyDescription

Obtiene o establece una descripción textual de la publicación.(Heredado de Publication).

System_CAPS_pubpropertyFtpAddress

Obtiene o establece la dirección del equipo servidor del Protocolo de transferencia de archivos (FTP) para las publicaciones que permiten la inicialización de suscripciones sobre FTP.(Heredado de Publication).

System_CAPS_pubpropertyFtpLogin

Obtiene o establece el inicio de sesión que se utiliza para la conexión al servidor del Protocolo de transferencia de archivos (FTP) para las publicaciones que permiten la inicialización de suscripciones sobre FTP.(Heredado de Publication).

System_CAPS_pubpropertyFtpPassword

Establece la contraseña del inicio de sesión que se utiliza para la conexión al servidor del Protocolo de transferencia de archivos (FTP) para las publicaciones que permiten la inicialización de suscripciones sobre FTP.(Heredado de Publication).

System_CAPS_pubpropertyFtpPort

Obtiene o establece el puerto del equipo servidor del Protocolo de transferencia de archivos (FTP) para las publicaciones que permiten la inicialización de suscripciones sobre FTP.(Heredado de Publication).

System_CAPS_pubpropertyFtpSubdirectory

Obtiene o establece el subdirectorio del equipo servidor del Protocolo de transferencia de archivos (FTP) para las publicaciones que permiten la inicialización de suscripciones sobre FTP.(Heredado de Publication).

System_CAPS_pubpropertyHasSubscription

Obtiene si la publicación tiene una o más suscripciones.(Heredado de Publication).

System_CAPS_pubpropertyIsExistingObject

Obtiene si el objeto existe en el servidor.(Heredado de ReplicationObject).

System_CAPS_pubpropertyName

Obtiene o establece el nombre de la publicación.(Heredado de Publication).

System_CAPS_pubpropertyPeerConflictDetectionEnabled

Obtiene si la detección de conflictos punto a punto se habilitó utilizando SetPeerConflictDetection.

System_CAPS_pubpropertyPeerOriginatorID

Obtiene el identificador de un nodo en una topología punto a punto; este identificador se usa para la detección de conflictos si PeerConflictDetectionEnabled está establecido en true.

System_CAPS_pubpropertyPostSnapshotScript

Obtiene o establece el nombre y la ruta de acceso completa de un archivo de script de Transact-SQL que se ejecuta una vez aplicada al suscriptor la instantánea inicial.(Heredado de Publication).

System_CAPS_pubpropertyPreSnapshotScript

Obtiene o establece el nombre y la ruta de acceso completa de un archivo de script de Transact-SQL que se ejecuta antes de aplicar al suscriptor la instantánea inicial.(Heredado de Publication).

System_CAPS_pubpropertyPubId

Obtiene el valor que identifica de forma unívoca la publicación. (Heredado de Publication).

System_CAPS_pubpropertyPublisherName

Obtiene o establece el nombre del publicador que no es de SQL Server.

System_CAPS_pubpropertyQueueType

Obtiene o establece el tipo de cola a usar para las publicaciones que permiten las suscripciones de actualización en cola.

System_CAPS_pubpropertyReplicateDdl

Obtiene o establece las opciones de replicación de lenguaje de definición de datos (DDL) que determinan si se replican los cambios de DDL.(Heredado de Publication).

System_CAPS_pubpropertyRetentionPeriod

Obtiene o establece la cantidad de tiempo que transcurre antes de que una suscripción expire si la suscripción no se sincroniza con la publicación.(Heredado de Publication).

System_CAPS_pubpropertySecureFtpPassword

Establece la contraseña (como un objeto SecureString) del inicio de sesión que se utiliza para la conexión al servidor del Protocolo de transferencia de archivos (FTP) para las publicaciones que permiten la inicialización de suscripciones sobre FTP.(Heredado de Publication).

System_CAPS_pubpropertySnapshotAgentExists

Obtiene si el trabajo del Agente de SQL Server sale para generar la instantánea inicial para esta publicación.(Heredado de Publication).

System_CAPS_pubpropertySnapshotAvailable

Obtiene si los archivos de instantánea están disponibles o no para uso en esta publicación.

System_CAPS_pubpropertySnapshotGenerationAgentProcessSecurity

Obtiene un objeto que establece la cuenta de Windows bajo la cual se ejecuta el trabajo del Agente de instantáneas.(Heredado de Publication).

System_CAPS_pubpropertySnapshotGenerationAgentPublisherSecurity

Obtiene el contexto de seguridad utilizado por el Agente de instantáneas para la conexión al publicador.(Heredado de Publication).

System_CAPS_pubpropertySnapshotJobId

Obtiene el identificador del trabajo del Agente de instantáneas para la publicación actual.(Heredado de Publication).

System_CAPS_pubpropertySnapshotMethod

Obtiene o establece el formato del archivo de datos de la instantánea inicial.(Heredado de Publication).

System_CAPS_pubpropertySnapshotSchedule

Obtiene un objeto que establece la programación para el Agente de instantáneas para la publicación actual.(Heredado de Publication).

System_CAPS_pubpropertySqlServerName

Obtiene el nombre de la instancia de Microsoft SQL Server a la que está conectado este objeto. (Heredado de ReplicationObject).

System_CAPS_pubpropertyStatus

Obtiene o establece el estado de la publicación.(Heredado de Publication).

System_CAPS_pubpropertyTransArticles

Representa los artículos de la publicación.

System_CAPS_pubpropertyTransSubscriptions

Representa las suscripciones de la publicación.

System_CAPS_pubpropertyType

Obtiene o establece el tipo de publicación.(Heredado de Publication).

System_CAPS_pubpropertyUserData

Obtiene o establece una propiedad de un objeto que permite a los usuarios adjuntar sus propios datos al objeto. (Heredado de ReplicationObject).

NombreDescripción
System_CAPS_pubmethodBrowseSnapshotFolder(String, String)

Devuelve la ruta de acceso completa de la ubicación donde se generaron los archivos de instantánea para una suscripción concreta.

System_CAPS_pubmethodCommitPropertyChanges()

Envía todas las instrucciones de cambio de propiedad almacenadas en memoria caché a la instancia de Microsoft SQL Server.(Heredado de ReplicationObject).

System_CAPS_pubmethodCopySnapshot(String, String, String)

Copia los últimos archivos de instantánea de una suscripción concreta en una carpeta de destino.

System_CAPS_pubmethodCreate()

Crea la publicación.(Heredado de Publication).

System_CAPS_pubmethodCreateSnapshotAgent()

Crea el trabajo de agente SQL Server que se utiliza para generar la instantánea inicial para la publicación, si este trabajo aún no existe.(Heredado de Publication).

System_CAPS_pubmethodDecouple()

Desacopla del servidor el objeto de replicación al que se hace referencia. (Heredado de ReplicationObject).

System_CAPS_pubmethodEnumArticles()

Devuelve los artículos de la publicación.(Heredado de Publication).

System_CAPS_pubmethodEnumPublicationAccesses(Boolean)

Devuelve los inicios de sesión que tienen acceso al publicador.(Heredado de Publication).

System_CAPS_pubmethodEnumSubscriptions()

Devuelve las suscripciones que se suscriben a la publicación.(Heredado de Publication).

System_CAPS_pubmethodEquals(Object)

(Heredado de Object).

System_CAPS_pubmethodGetHashCode()

(Heredado de Object).

System_CAPS_pubmethodGetType()

(Heredado de Object).

System_CAPS_pubmethodGrantPublicationAccess(String)

Agrega el inicio de sesión especificado a la lista de acceso a la publicación (PAL).(Heredado de Publication).

System_CAPS_pubmethodLoad()

Carga las propiedades de un objeto existente desde el servidor. (Heredado de ReplicationObject).

System_CAPS_pubmethodLoadProperties()

Carga las propiedades de un objeto existente desde el servidor. (Heredado de ReplicationObject).

System_CAPS_pubmethodMakePullSubscriptionWellKnown(String, String, SubscriptionSyncType, TransSubscriberType)

Registra una suscripción de extracción en el publicador.

System_CAPS_pubmethodPostTracerToken()

Envía un token de seguimiento al registro del publicador para comenzar el proceso de determinación de la latencia.

System_CAPS_pubmethodRefresh()

Vuelve a cargar las propiedades del objeto. (Heredado de ReplicationObject).

System_CAPS_pubmethodRefreshSubscriptions()

Actualiza todas las suscripciones a una publicación para incluir cualquier artículo agregado recientemente.

System_CAPS_pubmethodReinitializeAllSubscriptions()

Marca todas las suscripciones a la publicación para reinicialización.

System_CAPS_pubmethodReinitializeAllSubscriptions(Boolean)

Marca todas las suscripciones a la publicación para reinicialización, con la posibilidad de invalidar una instantánea existente.

System_CAPS_pubmethodRemove()

Quita una publicación existente.(Heredado de Publication).

System_CAPS_pubmethodRemove(Boolean)

Quita una publicación existente aun cuando no se pueda tener acceso al distribuidor.(Heredado de Publication).

System_CAPS_pubmethodRemovePullSubscription(String, String)

Quita el registro de una suscripción de extracción del publicador.

System_CAPS_pubmethodReplicateUserDefinedScript(String)

Replica la ejecución de un script definido por el usuario en los suscriptores de una publicación especificada.(Heredado de Publication).

System_CAPS_pubmethodRevokePublicationAccess(String)

Quita el inicio de sesión especificado de la lista de acceso a la publicación (PAL).(Heredado de Publication).

System_CAPS_pubmethodScript(ScriptOptions)

Genera un script de Transact-SQL que se puede usar para volver a crear la publicación como se especifica en las opciones del script.(Heredado de Publication).

System_CAPS_pubmethodSetPeerConflictDetection(Boolean, Int32)

Habilita o deshabilita la detección de conflictos para un nodo en una topología punto a punto.

System_CAPS_pubmethodStartSnapshotGenerationAgentJob()

Inicia el trabajo que genera la instantánea inicial para la publicación.(Heredado de Publication).

System_CAPS_pubmethodStopSnapshotGenerationAgentJob()

Intenta detener un trabajo del Agente de instantáneas en ejecución.(Heredado de Publication).

System_CAPS_pubmethodToString()

(Heredado de Object).

System_CAPS_pubmethodValidatePublication(ValidationOption, ValidationMethod, Boolean)

Invoca la validación de publicación insertada para todas las suscripciones.

System_CAPS_pubmethodValidateSubscriptions(String[], String[], ValidationOption, ValidationMethod, Boolean)

Invoca la validación de publicación insertada para la suscripción especificada.

Cualquier (Shared Microsoft en Visual Basic) miembros estáticos públicos de este tipo son seguros para operaciones multiproceso. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Este ejemplo crea una publicación transaccional.


  // Set the Publisher, publication database, and publication names.
string publicationName = "AdvWorksProductTran";
string publicationDbName = "AdventureWorks2012";
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 AdventureWorks2012 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 = "AdventureWorks2012"
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 AdventureWorks2012 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

Este ejemplo elimina una publicación transaccional.


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

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 = "AdventureWorks2012"

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

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: