Publication Class

Definition

The Publication class is a base class from which the TransPublication class and the MergePublication class are derived.

public ref class Publication abstract : Microsoft::SqlServer::Replication::ReplicationObject
public abstract class Publication : Microsoft.SqlServer.Replication.ReplicationObject
type Publication = class
    inherit ReplicationObject
Public MustInherit Class Publication
Inherits ReplicationObject
Inheritance
Derived

Remarks

When configuring a Publisher with a remote Distributor, the values supplied for all properties, including SnapshotGenerationAgentProcessSecurity, are sent to the Distributor as plain text. You should encrypt the connection between the Publisher and its remote Distributor before calling the Create or the CreateSnapshotAgent methods. For more information, see sp_changemergepublication (Transact-SQL).

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are safe for multithreaded operations. Any instance members are not guaranteed to be thread safe.

Constructors

Publication()

Creates a new instance of the Publication class.

Properties

AltSnapshotFolder

Gets or sets the alternate snapshot file location for a publication.

Attributes

Gets or sets the publication attributes.

CachePropertyChanges

Gets or sets whether to cache changes made to the replication properties or to apply them immediately.

(Inherited from ReplicationObject)
CompatibilityLevel

Gets or sets the earliest version of Microsoft SQL Server running on the Subscribers that the referenced publication can support.

ConflictRetention

Gets or sets the number of days that conflict data rows are retained in conflict tables.

ConnectionContext

Gets or sets the connection to an instance of Microsoft SQL Server.

(Inherited from ReplicationObject)
CreateSnapshotAgentByDefault

Gets or sets if the Snapshot Agent job is added automatically when the publication is created.

DatabaseName

Gets or sets the name of the publication database.

Description

Gets or sets a textual description of the publication.

FtpAddress

Gets or sets the address of the File Transfer Protocol (FTP) server computer for publications that allow subscription initialization over FTP.

FtpLogin

Gets or sets the login that is used to connect to the File Transfer Protocol (FTP) server for publications that allow subscription initialization over FTP.

FtpPassword

Sets the password for the login that is used to connect to the File Transfer Protocol (FTP) server for publications that allow subscription initialization over FTP.

FtpPort

Gets or sets the port of the File Transfer Protocol (FTP) server computer for publications that allow subscription initialization over FTP.

FtpSubdirectory

Gets or sets the subdirectory on the File Transfer Protocol (FTP) server computer for publications that allow subscription initialization over FTP.

HasSubscription

Gets whether the publication has one or more subscriptions.

IsExistingObject

Gets whether the object exists on the server or not.

(Inherited from ReplicationObject)
Name

Gets or sets the name of the publication.

PostSnapshotScript

Gets or sets the name and full path of a Transact-SQL script file that is executed after the initial snapshot is applied to the Subscriber.

PreSnapshotScript

Gets or sets the name and full path of a Transact-SQL script file that is executed before the initial snapshot is applied to the Subscriber.

PubId

Gets the value that uniquely identifies the publication.

ReplicateDdl

Gets or sets the data definition language (DDL) replication options that determine if DDL changes are replicated.

RetentionPeriod

Gets or sets the amount of time before a subscription expires when the subscription is not synchronized with the publication.

SecureFtpPassword

Sets the password (as a SecureString object) for the login used to connect to the File Transfer Protocol (FTP) server for publications that allow subscription initialization over FTP.

SnapshotAgentExists

Gets if the SQL Server Agent job exists to generate the initial snapshot for this publication.

SnapshotGenerationAgentProcessSecurity

Gets an object that sets the Windows account under which the Snapshot Agent job runs.

SnapshotGenerationAgentPublisherSecurity

Gets the security context used by the Snapshot Agent to connect to the Publisher.

SnapshotJobId

Gets the Snapshot Agent job ID for the current publication.

SnapshotMethod

Gets or sets the data file format of the initial snapshot.

SnapshotSchedule

Gets an object that sets the schedule for the Snapshot Agent for the current publication.

SqlServerName

Gets the name of the Microsoft SQL Server instance to which this object is connected.

(Inherited from ReplicationObject)
Status

Gets or sets the status of the publication.

Type

Gets or sets the type of publication.

UserData

Gets or sets an object property that allows users to attach their own data to the object.

(Inherited from ReplicationObject)

Methods

CheckValidCreation()

Checks the valid replication creation.

(Inherited from ReplicationObject)
CheckValidDefinition(Boolean)

Indicates whether to check valid definition.

CommitPropertyChanges()

Sends all the cached property change statements to the instance of Microsoft SQL Server.

(Inherited from ReplicationObject)
Create()

Creates the publication.

CreateSnapshotAgent()

Creates the SQL Server Agent job that is used to generate the initial snapshot for the publication, if this job does not already exist.

Decouple()

Decouples the referenced replication object from the server.

(Inherited from ReplicationObject)
EnumArticles()

Returns the articles in the publication.

EnumPublicationAccesses(Boolean)

Returns logins that have access to the Publisher.

EnumSubscriptions()

Returns the subscriptions that subscribe to the publication.

GetChangeCommand(StringBuilder, String, String)

Returns the change command from the replication.

(Inherited from ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)

Returns the create command from the replication.

(Inherited from ReplicationObject)
GetDropCommand(StringBuilder, Boolean)

Returns the drop command from the replication.

(Inherited from ReplicationObject)
GrantPublicationAccess(String)

Adds the specified login to the publication access list (PAL).

InternalRefresh(Boolean)

Initiates an internal refresh from the replication.

(Inherited from ReplicationObject)
Load()

Loads the properties of an existing object from the server.

(Inherited from ReplicationObject)
LoadProperties()

Loads the properties of an existing object from the server.

(Inherited from ReplicationObject)
Refresh()

Reloads the properties of the object.

(Inherited from ReplicationObject)
Remove()

Removes an existing publication.

Remove(Boolean)

Removes an existing publication even if the Distributor cannot be accessed.

ReplicateUserDefinedScript(String)

Replicates the execution of a user-defined script to the Subscribers of a specified publication.

RevokePublicationAccess(String)

Removes the specified login from the publication access list (PAL).

Script(ScriptOptions)

Generates a Transact-SQL script that can be used to re-create the publication as specified by the script options.

StartSnapshotGenerationAgentJob()

Starts the job that generates the initial snapshot for the publication.

StopSnapshotGenerationAgentJob()

Attempts to stop a running Snapshot Agent job.

Applies to