Freigeben über


MergePublication-Klasse

Represents a merge publication.

Vererbungshierarchie

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

Namespace:  Microsoft.SqlServer.Replication
Assembly:  Microsoft.SqlServer.Rmo (in Microsoft.SqlServer.Rmo.dll)

Syntax

'Declaration
Public NotInheritable Class MergePublication _
    Inherits Publication
'Usage
Dim instance As MergePublication
public sealed class MergePublication : Publication
public ref class MergePublication sealed : public Publication
[<SealedAttribute>]
type MergePublication =  
    class 
        inherit Publication 
    end
public final class MergePublication extends Publication

Der MergePublication-Typ macht folgende Elemente verfügbar.

Konstruktoren

  Name Beschreibung
Öffentliche Methode MergePublication() Creates a new instance of the MergePublication class.
Öffentliche Methode MergePublication(String, String, ServerConnection) Initializes a new instance of the MergePublication class with the specified name, database, and connection to the Publisher.
Öffentliche Methode MergePublication(String, String, ServerConnection, Boolean) Creates an instance of the MergePublication class, specifying whether the Snapshot Agent job should be created by default.

Zum Anfang

Eigenschaften

  Name Beschreibung
Öffentliche Eigenschaft AltSnapshotFolder Gets or sets the alternate snapshot file location for a publication. (Geerbt von Publication.)
Öffentliche Eigenschaft Attributes Gets or sets the publication attributes. (Geerbt von Publication.)
Öffentliche Eigenschaft AutomaticReinitializationPolicy Gets or sets whether changes at the Publisher are uploaded to the Publisher when a subscription is reinitialized because of a change in the publication.
Öffentliche Eigenschaft CachePropertyChanges Gets or sets whether to cache changes made to the replication properties or to apply them immediately. (Geerbt von ReplicationObject.)
Öffentliche Eigenschaft CompatibilityLevel Gets or sets the earliest version of Microsoft SQL Server that can subscribe to the merge publication. (Überschreibt Publication.CompatibilityLevel.)
Öffentliche Eigenschaft ConflictRetention Gets or sets the number of days that conflict data rows are retained in conflict tables. (Geerbt von Publication.)
Öffentliche Eigenschaft ConnectionContext Gets or sets the connection to an instance of Microsoft SQL Server. (Geerbt von ReplicationObject.)
Öffentliche Eigenschaft CreateSnapshotAgentByDefault Gets or sets if the Snapshot Agent job is added automatically when the publication is created. (Geerbt von Publication.)
Öffentliche Eigenschaft DatabaseName Gets or sets the name of the publication database. (Geerbt von Publication.)
Öffentliche Eigenschaft Description Gets or sets a textual description of the publication. (Geerbt von Publication.)
Öffentliche Eigenschaft FtpAddress Gets or sets the address of the File Transfer Protocol (FTP) server computer for publications that allow subscription initialization over FTP. (Geerbt von Publication.)
Öffentliche Eigenschaft 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. (Geerbt von Publication.)
Öffentliche Eigenschaft 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. (Geerbt von Publication.)
Öffentliche Eigenschaft FtpPort Gets or sets the port of the File Transfer Protocol (FTP) server computer for publications that allow subscription initialization over FTP. (Geerbt von Publication.)
Öffentliche Eigenschaft FtpSubdirectory Gets or sets the subdirectory on the File Transfer Protocol (FTP) server computer for publications that allow subscription initialization over FTP. (Geerbt von Publication.)
Öffentliche Eigenschaft HasSubscription Gets whether the publication has one or more subscriptions. (Geerbt von Publication.)
Öffentliche Eigenschaft IsExistingObject Gets whether the object exists on the server or not. (Geerbt von ReplicationObject.)
Öffentliche Eigenschaft MaxConcurrentDynamicSnapshots Gets or sets the maximum number of concurrent Snapshot Agent sessions supported when generating data snapshots when the publication has a parameterized row filter.
Öffentliche Eigenschaft MaxConcurrentMerge Gets or sets the maximum number of Merge Agents that can synchronize with the publication concurrently.
Öffentliche Eigenschaft MergeArticles Gets the existing articles in the merge publication.
Öffentliche Eigenschaft MergeSubscriptions Gets the subscriptions that belong to a merge publication.
Öffentliche Eigenschaft Name Gets or sets the name of the publication. (Geerbt von Publication.)
Öffentliche Eigenschaft PartitionGroupsOption Gets or sets whether precomputed partitions should be used to optimize the synchronization process.
Öffentliche Eigenschaft 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. (Geerbt von Publication.)
Öffentliche Eigenschaft 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. (Geerbt von Publication.)
Öffentliche Eigenschaft Priority Infrastruktur Gets the priority of the publication.
Öffentliche Eigenschaft PubId Gets the value that uniquely identifies the publication. (Geerbt von Publication.)
Öffentliche Eigenschaft ReplicateDdl Gets or sets the data definition language (DDL) replication options that determine if DDL changes are replicated. (Geerbt von Publication.)
Öffentliche Eigenschaft RetentionPeriod Gets or sets the amount of time before a subscription expires when the subscription is not synchronized with the publication. (Geerbt von Publication.)
Öffentliche Eigenschaft RetentionPeriodUnit Gets or sets the unit in which the RetentionPeriodUnit property is expressed.
Öffentliche Eigenschaft 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. (Geerbt von Publication.)
Öffentliche Eigenschaft SnapshotAgentExists Gets if the SQL Server Agent job exists to generate the initial snapshot for this publication. (Geerbt von Publication.)
Öffentliche Eigenschaft SnapshotAvailable Gets or sets a value that indicates whether the snapshot files for this publication have been generated and are available to initialize Subscribers.
Öffentliche Eigenschaft SnapshotGenerationAgentProcessSecurity Gets an object that sets the Windows account under which the Snapshot Agent job runs. (Geerbt von Publication.)
Öffentliche Eigenschaft SnapshotGenerationAgentPublisherSecurity Gets the security context used by the Snapshot Agent to connect to the Publisher. (Geerbt von Publication.)
Öffentliche Eigenschaft SnapshotJobId Gets the Snapshot Agent job ID for the current publication. (Geerbt von Publication.)
Öffentliche Eigenschaft SnapshotMethod Gets or sets the data file format of the initial snapshot. (Geerbt von Publication.)
Öffentliche Eigenschaft SnapshotSchedule Gets an object that sets the schedule for the Snapshot Agent for the current publication. (Geerbt von Publication.)
Öffentliche Eigenschaft SqlServerName Gets the name of the Microsoft SQL Server instance to which this object is connected. (Geerbt von ReplicationObject.)
Öffentliche Eigenschaft Status Gets or sets the status of the publication. (Geerbt von Publication.)
Öffentliche Eigenschaft Type Gets or sets the type of publication. (Geerbt von Publication.)
Öffentliche Eigenschaft UserData Gets or sets an object property that allows users to attach their own data to the object. (Geerbt von ReplicationObject.)
Öffentliche Eigenschaft UsesHostName Gets a value that indicates whether the merge publication has a parameterized row filter that uses the HOST_NAME function to evaluate the partition.
Öffentliche Eigenschaft ValidateSubscriberInfo Gets or sets the functions that are used to define a Subscriber partition of the published data when parameterized row filters are used.
Öffentliche Eigenschaft WebSynchronizationUrl Gets or sets the URL used with Web synchronization.

Zum Anfang

Methoden

  Name Beschreibung
Öffentliche Methode AddMergeDynamicSnapshotJob Adds a Snapshot Agent job that generates the filtered data partition for a Subscriber when a parameterized row filter is used.
Öffentliche Methode AddMergeDynamicSnapshotJobForLateBoundComClients Enables late-bound COM clients to add a Snapshot Agent job that generates the filtered data partition for a Subscriber when a parameterized row filter is used.
Öffentliche Methode AddMergePartition Defines a Subscriber partition for a merge publication with a parameterized row filter.
Öffentliche Methode BrowseSnapshotFolder Returns the complete path of the directory location where snapshot files are generated.
Öffentliche Methode ChangeMergeDynamicSnapshotJobScheduleWithJobId Modifies the schedule for the Snapshot Agent job that generates the filtered data partition for a Subscriber, based on the job ID.
Öffentliche Methode ChangeMergeDynamicSnapshotJobScheduleWithJobIdForLateBoundComClients Allows late-bound COM clients to modify the schedule for the Snapshot Agent job that generates the filtered data partition for a Subscriber, based on the job ID.
Öffentliche Methode ChangeMergeDynamicSnapshotJobScheduleWithJobName Modifies the schedule for the Snapshot Agent job that generates the filtered data partition for a Subscriber, based on the job name.
Öffentliche Methode ChangeMergeDynamicSnapshotJobScheduleWithJobNameForLateBoundComClients Allows late-bound COM clients to modify the schedule for the Snapshot Agent job that generates the filtered data partition for a Subscriber, based on the job name.
Öffentliche Methode CommitPropertyChanges Sends all the cached property change statements to the instance of Microsoft SQL Server. (Geerbt von ReplicationObject.)
Öffentliche Methode CopySnapshot Copies the snapshot files for the merge publication from the snapshot folder to a destination folder.
Öffentliche Methode Create Creates the publication. (Geerbt von Publication.)
Öffentliche Methode 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. (Geerbt von Publication.)
Öffentliche Methode Decouple Decouples the referenced replication object from the server. (Geerbt von ReplicationObject.)
Öffentliche Methode DisableSynchronizationPartner Disables the specified synchronization partner for this merge publication.
Öffentliche Methode EnableSynchronizationPartner Enables a specified synchronization partner for this merge publication.
Öffentliche Methode EnumAllMergeJoinFilters Returns all the merge join filters defined on the merge publication.
Öffentliche Methode EnumArticles Returns the articles in the publication. (Geerbt von Publication.)
Öffentliche Methode EnumMergeDynamicSnapshotJobs Returns a list of merge dynamic snapshot jobs.
Öffentliche Methode EnumMergePartitions Returns the Subscriber partitions defined for this merge publication.
Öffentliche Methode EnumPublicationAccesses Returns logins that have access to the Publisher. (Geerbt von Publication.)
Öffentliche Methode EnumSubscriptions Returns the subscriptions that subscribe to the publication. (Geerbt von Publication.)
Öffentliche Methode EnumSynchronizationPartners Returns the alternate synchronization partners for this merge publication.
Öffentliche Methode Equals (Geerbt von Object.)
Öffentliche Methode GenerateFilters Infrastruktur Creates filters of the merge publication.
Öffentliche Methode GetHashCode (Geerbt von Object.)
Öffentliche Methode GetMergeDynamicSnapshotJobScheduleWithJobId Returns the schedule for the Snapshot Agent job that generates the filtered data partition for a Subscriber based on the job ID.
Öffentliche Methode GetMergeDynamicSnapshotJobScheduleWithJobName Returns the schedule for the Snapshot Agent job that generates the filtered data partition for a Subscriber based on the job name.
Öffentliche Methode GetType (Geerbt von Object.)
Öffentliche Methode GrantPublicationAccess Adds the specified login to the publication access list (PAL). (Geerbt von Publication.)
Öffentliche Methode Load Loads the properties of an existing object from the server. (Geerbt von ReplicationObject.)
Öffentliche Methode LoadProperties Loads the properties of an existing object from the server. (Geerbt von ReplicationObject.)
Öffentliche Methode MakePullSubscriptionWellKnown Registers a merge pull subscription at the Publisher.
Öffentliche Methode ReadLastValidationDateTimes Returns information about the most recent subscription validation for a Subscriber.
Öffentliche Methode Refresh Reloads the properties of the object. (Geerbt von ReplicationObject.)
Öffentliche Methode ReinitializeAllSubscriptions Marks all the subscriptions for reinitialization.
Öffentliche Methode Remove() Removes an existing publication. (Geerbt von Publication.)
Öffentliche Methode Remove(Boolean) Removes an existing publication even if the Distributor cannot be accessed. (Geerbt von Publication.)
Öffentliche Methode RemoveMergeDynamicSnapshotJob Removes the specified dynamic snapshot job from the merge publication.
Öffentliche Methode RemoveMergePartition Removes an existing Subscriber partition defined on the merge publication.
Öffentliche Methode RemovePullSubscription Removes the registration of a Subscriber with a pull subscription to the merge publication.
Öffentliche Methode ReplicateUserDefinedScript Replicates the execution of a user-defined script to the Subscribers of a specified publication. (Geerbt von Publication.)
Öffentliche Methode ResynchronizeSubscription Resynchronizes a merge subscription to a known validation state that you specify.
Öffentliche Methode RevokePublicationAccess Removes the specified login from the publication access list (PAL). (Geerbt von Publication.)
Öffentliche Methode Script Generates a Transact-SQL script that can be used to re-create the publication as specified by the script options. (Geerbt von Publication.)
Öffentliche Methode ScriptMergeDynamicSnapshotJob Generates a Transact-SQL script that can be used to re-create the Snapshot Agent job that generates a Subscriber's partitioned data snapshot for publications with a parameterized row filter.
Öffentliche Methode ScriptMergePartition Generates a Transact-SQL script that can be used to re-create a Subscriber partition for publications with a parameterized row filter.
Öffentliche Methode ScriptPublicationActivation Generates a Transact-SQL script that, when run, sets the status of a merge publication to active.
Öffentliche Methode StartSnapshotGenerationAgentJob Starts the job that generates the initial snapshot for the publication. (Geerbt von Publication.)
Öffentliche Methode StopSnapshotGenerationAgentJob Attempts to stop a running Snapshot Agent job. (Geerbt von Publication.)
Öffentliche Methode ToString (Geerbt von Object.)
Öffentliche Methode ValidatePublication Marks all subscriptions for validation during the next synchronization.
Öffentliche Methode ValidateSubscription Marks the specified subscription for validation during the next synchronization.

Zum Anfang

Hinweise

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.

Beispiele

This example creates a merge publication.

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

            ReplicationDatabase publicationDb;
            MergePublication publication;

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

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

                // Enable the database for merge publication.               
                publicationDb = new ReplicationDatabase(publicationDbName, conn);
                if (publicationDb.LoadProperties())
                {
                    if (!publicationDb.EnabledMergePublishing)
                    {
                        publicationDb.EnabledMergePublishing = true;
                    }
                }
                else
                {
                    // Do something here if the database does not exist. 
                    throw new ApplicationException(String.Format(
                        "The {0} database does not exist on {1}.",
                        publicationDb, publisherName));
                }

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

                // Enable precomputed partitions.
                publication.PartitionGroupsOption = PartitionGroupsOption.True;

                // 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;

                // Enable Subscribers to request snapshot generation and filtering.
                publication.Attributes |= PublicationAttributes.AllowSubscriberInitiatedSnapshot;
                publication.Attributes |= PublicationAttributes.DynamicFilters;

                // Enable pull and push subscriptions.
                publication.Attributes |= PublicationAttributes.AllowPull;
                publication.Attributes |= PublicationAttributes.AllowPush;

                if (!publication.IsExistingObject)
                {
                    // Create the merge 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 publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publicationDbName As String = "AdventureWorks2012"

Dim publicationDb As ReplicationDatabase
Dim publication As MergePublication

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

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

    ' Enable the database for merge publication.                
    publicationDb = New ReplicationDatabase(publicationDbName, conn)
    If publicationDb.LoadProperties() Then
        If Not publicationDb.EnabledMergePublishing Then
            publicationDb.EnabledMergePublishing = True
        End If
    Else
        ' Do something here if the database does not exist. 
        Throw New ApplicationException(String.Format( _
         "The {0} database does not exist on {1}.", _
         publicationDb, publisherName))
    End If

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

    ' Enable precomputed partitions.
    publication.PartitionGroupsOption = PartitionGroupsOption.True

    ' 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

    ' Enable Subscribers to request snapshot generation and filtering.
    publication.Attributes = publication.Attributes Or _
        PublicationAttributes.AllowSubscriberInitiatedSnapshot
    publication.Attributes = publication.Attributes Or _
        PublicationAttributes.DynamicFilters

    ' Enable pull and push subscriptions
    publication.Attributes = publication.Attributes Or _
        PublicationAttributes.AllowPull
    publication.Attributes = publication.Attributes Or _
        PublicationAttributes.AllowPush

    If Not publication.IsExistingObject Then
        ' Create the merge 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

This example changes the properties of a merge publication.

         // Define the server, database, and publication names
            string publisherName = publisherInstance;
            string publicationName = "AdvWorksSalesOrdersMerge";
            string publicationDbName = "AdventureWorks2012";

            MergePublication publication;

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

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

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


                // If we can't get the properties for this merge publication, then throw an application exception.
                if (publication.LoadProperties())
                {
                    // If DDL replication is currently enabled, disable it.
                    if (publication.ReplicateDdl == DdlReplicationOptions.All)
                    {
                        publication.ReplicateDdl = DdlReplicationOptions.None;
                    }
                    else
                    {
                        publication.ReplicateDdl = DdlReplicationOptions.All;
                    }
                }
                else
                {
                    throw new ApplicationException(String.Format(
                        "Settings could not be retrieved for the publication. " +
                        "Ensure that the publication {0} exists on {1}.",
                        publicationName, publisherName));
                }
            }
            catch (Exception ex)
            {
                // Do error handling here.
                throw new ApplicationException(
                    "The publication property could not be changed.", ex);
            }
            finally
            {
                conn.Disconnect();
            }
' Define the server, database, and publication names
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publicationDbName As String = "AdventureWorks2012"

Dim publication As MergePublication

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

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

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

    ' If we can't get the properties for this merge publication, then throw an application exception.
    If publication.LoadProperties() Then
        ' If DDL replication is currently enabled, disable it.
        If publication.ReplicateDdl = DdlReplicationOptions.All Then
            publication.ReplicateDdl = DdlReplicationOptions.None
        Else
            publication.ReplicateDdl = DdlReplicationOptions.All
        End If
    Else
        Throw New ApplicationException(String.Format( _
         "Settings could not be retrieved for the publication. " + _
         "Ensure that the publication {0} exists on {1}.", _
         publicationName, publisherName))
    End If
Catch ex As Exception
    ' Do error handling here.
    Throw New ApplicationException( _
        "The publication property could not be changed.", ex)
Finally
    conn.Disconnect()
End Try

This example deletes a merge publication.

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

            MergePublication publication;
            ReplicationDatabase publicationDb;

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

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

                // Set the required properties for the merge publication.
                publication = new MergePublication();
                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 merge publications exists,
                // disable publishing on the database.
                publicationDb = new ReplicationDatabase(publicationDbName, conn);
                if (publicationDb.LoadProperties())
                {
                    if (publicationDb.MergePublications.Count == 0 && publicationDb.EnabledMergePublishing)
                    {
                        publicationDb.EnabledMergePublishing = 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 = "AdvWorksSalesOrdersMerge"
Dim publicationDbName As String = "AdventureWorks2012"

Dim publication As MergePublication
Dim publicationDb As ReplicationDatabase

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

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

    ' Set the required properties for the merge publication.
    publication = New MergePublication()
    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 merge publications exists,
    ' disable publishing on the database.
    publicationDb = New ReplicationDatabase(publicationDbName, conn)
    If publicationDb.LoadProperties() Then
        If publicationDb.MergePublications.Count = 0 _
        And publicationDb.EnabledMergePublishing Then
            publicationDb.EnabledMergePublishing = 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

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Elemente dieses Typs sind Threadsicher. Für Instanzelemente wird die Threadsicherheit nicht gewährleistet.

Siehe auch

Verweis

Microsoft.SqlServer.Replication-Namespace

Andere Ressourcen

Vorgehensweise: Erstellen einer Veröffentlichung (RMO-Programmierung)

Vorgehensweise: Anzeigen und Ändern von Veröffentlichungseigenschaften (RMO-Programmierung)