Artykuł
07/22/2011

Klasa MergePartition

Reprezentuje informacje dotyczące partycji subskrybenta do publikacja korespondencji seryjnej z sparametryzowany filtr wierszy.

Hierarchia dziedziczenia

System.Object
Microsoft.SqlServer.Replication.MergePartition

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

Składnia

'Deklaracja
Public NotInheritable Class MergePartition
'Użycie
Dim instance As MergePartition

public sealed class MergePartition

public ref class MergePartition sealed

[<SealedAttribute>]
type MergePartition =  class end

public final class MergePartition

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

Konstruktorzy

	Nazwa	Opis
	MergePartition	Tworzy nowe wystąpienie MergePartition klasy

Do góry

Właściwości

	Nazwa	Opis
	CurrentSnapshotDateTime	Pobiera lub ustawia data i czas, kiedy dane migawka partycji został wygenerowany.
	DynamicFilterHostName	Pobiera lub ustawia wartość dostarczonych do HOST_NAME (Transact-SQL) funkcja do generowania danych migawka, gdy filtr parametrami wiersza jest definiowana za pomocą funkcja.
	DynamicFilterLogin	Pobiera lub ustawia wartość dostarczonych do SUSER_SNAME (Transact-SQL) funkcja do generowania danych migawka, gdy filtr parametrami wiersza jest definiowana za pomocą funkcja.
	DynamicSnapshotJobId	Gets or sets the Microsoft SQL Server Agent job ID, in hexadecimal format, which generates the filtered snapshot for the Subscriber.
	DynamicSnapshotLocation	Pobiera lub ustawia folder systemu operacyjnego, używane do przechowywania filtrowane migawka generowane dla partycji.
	PartitionId	Pobiera lub ustawia wartość Identyfikatora, który unikatowo identyfikuje partycję.
	UserData	Pobiera lub ustawia obiekt, który pozwala dołączyć niestandardowe dane do tego wystąpienie MergePartition.

Do góry

Metody

	Nazwa	Opis
	Equals	(Dziedziczony z Object).
	Finalize	(Dziedziczony z Object).
	GetHashCode	(Dziedziczony z Object).
	GetType	(Dziedziczony z Object).
	MemberwiseClone	(Dziedziczony z Object).
	ToString	(Dziedziczony z Object).

Do góry

Uwagi

Ten obszar nazw, klasy lub element członkowski jest obsługiwany tylko w wersja 2.0 Microsoft .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

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

            MergePublication publication;
            MergePartition partition;
            MergeDynamicSnapshotJob snapshotAgentJob;
            ReplicationAgentSchedule schedule;
            
            // Create a connection to the Publisher.
            ServerConnection publisherConn = new ServerConnection(publisherName);

            // Create a connection to the Distributor to start the Snapshot Agent.
            ServerConnection distributorConn = new ServerConnection(distributorName);

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

                // Set the required properties for the publication.
                publication = new MergePublication();
                publication.ConnectionContext = publisherConn;
                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() || publication.SnapshotAvailable)
                {
                    // Set a weekly schedule for the filtered data snapshot.
                    schedule = new ReplicationAgentSchedule();
                    schedule.FrequencyType = ScheduleFrequencyType.Weekly;
                    schedule.FrequencyRecurrenceFactor = 1;
                    schedule.FrequencyInterval = Convert.ToInt32(0x001);

                    // Set the value of Hostname that defines the data partition. 
                    partition = new MergePartition();
                    partition.DynamicFilterHostName = hostname;
                    snapshotAgentJob = new MergeDynamicSnapshotJob();
                    snapshotAgentJob.DynamicFilterHostName = hostname;

                    // Create the partition for the publication with the defined schedule.
                    publication.AddMergePartition(partition);
                    publication.AddMergeDynamicSnapshotJob(snapshotAgentJob, schedule);
                }
                else
                {
                    throw new ApplicationException(String.Format(
                        "Settings could not be retrieved for the publication, " +
                        " or the initial snapshot has not been generated. " +
                        "Ensure that the publication {0} exists on {1} and " +
                        "that the Snapshot Agent has run successfully.",
                        publicationName, publisherName));
                }
            }
            catch (Exception ex)
            {
                // Do error handling here.
                throw new ApplicationException(string.Format(
                    "The partition for '{0}' in the {1} publication could not be created.",
                    hostname, publicationName), ex);
            }
            finally
            {
                publisherConn.Disconnect();
                if (distributorConn.IsOpen) distributorConn.Disconnect();
            }

' Define the server, database, and publication names
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publicationDbName As String = "AdventureWorks2008R2"
Dim distributorName As String = publisherInstance

Dim publication As MergePublication
Dim partition As MergePartition
Dim snapshotAgentJob As MergeDynamicSnapshotJob
Dim schedule As ReplicationAgentSchedule

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

' Create a connection to the Distributor to start the Snapshot Agent.
Dim distributorConn As ServerConnection = New ServerConnection(distributorName)

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

    ' Set the required properties for the publication.
    publication = New MergePublication()
    publication.ConnectionContext = publisherConn
    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() Or publication.SnapshotAvailable) Then
        ' Set a weekly schedule for the filtered data snapshot.
        schedule = New ReplicationAgentSchedule()
        schedule.FrequencyType = ScheduleFrequencyType.Weekly
        schedule.FrequencyRecurrenceFactor = 1
        schedule.FrequencyInterval = Convert.ToInt32("0x001", 16)

        ' Set the value of Hostname that defines the data partition. 
        partition = New MergePartition()
        partition.DynamicFilterHostName = hostname
        snapshotAgentJob = New MergeDynamicSnapshotJob()
        snapshotAgentJob.DynamicFilterHostName = hostname

        ' Create the partition for the publication with the defined schedule.
        publication.AddMergePartition(partition)
        publication.AddMergeDynamicSnapshotJob(snapshotAgentJob, schedule)
    Else
        Throw New ApplicationException(String.Format( _
         "Settings could not be retrieved for the publication, " + _
         " or the initial snapshot has not been generated. " + _
         "Ensure that the publication {0} exists on {1} and " + _
         "that the Snapshot Agent has run successfully.", _
         publicationName, publisherName))
    End If
Catch ex As Exception
    ' Do error handling here.
    Throw New ApplicationException(String.Format( _
     "The partition for '{0}' in the {1} publication could not be created.", _
     hostname, publicationName), ex)
Finally
    publisherConn.Disconnect()
    If distributorConn.IsOpen Then
        distributorConn.Disconnect()
    End If
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.