Artykuł
07/22/2011

Właściwość SnapshotGenerationAgent.DynamicFilterHostName

Pobiera lub ustawia wartość dostarczonych do HOST_NAME w funkcji sparametryzowany filtr wierszy.

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

Składnia

'Deklaracja
Public Property DynamicFilterHostName As String
    Get
    Set
'Użycie
Dim instance As SnapshotGenerationAgent
Dim value As String

value = instance.DynamicFilterHostName

instance.DynamicFilterHostName = value

public string DynamicFilterHostName { get; set; }

public:
virtual property String^ DynamicFilterHostName {
    String^ get () sealed;
    void set (String^ value) sealed;
}

abstract DynamicFilterHostName : string with get, set
override DynamicFilterHostName : string with get, set

final function get DynamicFilterHostName () : String
final function set DynamicFilterHostName (value : String)

Wartość właściwości

Typ: System.String
A String wartość używana do filtrowania.

Implementacje

ISnapshotGenerationAgent.DynamicFilterHostName

Uwagi

Wartość określona dla DynamicFilterHostName jest używana podczas generowania partycjonowana migawka dla subskrypcja zdefiniowane na podstawie sparametryzowany filtr wierszy, który używa HOST_NAME funkcja.Na przykład jeśli podzbiór filtr klauzula LoginID = HOST_NAME() określonych w artykule i ustawieniu DynamicFilterHostName właściwość "adventure works\garrett1" przed wywołaniem agenta scalić tylko wiersze, posiadające "adventure works\garrett1" w login_id kolumna zostanie zreplikowana.

DynamicFilterHostName Właściwość jest obsługiwana tylko dla publikacji korespondencji seryjnej.

Nie należy określać wartość dla DynamicFilterHostName określając wartość dla DynamicFilterLogin.

Przykłady

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

            SnapshotGenerationAgent agent;

            try
            {
                // Set the required properties for Snapshot Agent.
                agent = new SnapshotGenerationAgent();
                agent.Distributor = distributorName;
                agent.DistributorSecurityMode = SecurityMode.Integrated;
                agent.Publisher = publisherName;
                agent.PublisherSecurityMode = SecurityMode.Integrated;
                agent.Publication = publicationName;
                agent.PublisherDatabase = publicationDbName;
                agent.ReplicationType = ReplicationType.Merge;

                // Specify the partition information to generate a 
                // filtered snapshot based on Hostname.
                agent.DynamicFilterHostName = hostname;

                // Start the agent synchronously.
                agent.GenerateSnapshot();
            }
            catch (Exception ex)
            {
                // Implement custom application error handling here.
                throw new ApplicationException(String.Format(
                    "A snapshot could not be generated for the {0} publication."
                    , publicationName), ex);
            }

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

Dim agent As SnapshotGenerationAgent

Try
    ' Set the required properties for Snapshot Agent.
    agent = New SnapshotGenerationAgent()
    agent.Distributor = distributorName
    agent.DistributorSecurityMode = SecurityMode.Integrated
    agent.Publisher = publisherName
    agent.PublisherSecurityMode = SecurityMode.Integrated
    agent.Publication = publicationName
    agent.PublisherDatabase = publicationDbName
    agent.ReplicationType = ReplicationType.Merge

    ' Specify the partition information to generate a 
    ' filtered snapshot based on Hostname.
    agent.DynamicFilterHostName = hostname

    ' Start the agent synchronously.
    agent.GenerateSnapshot()
Catch ex As Exception
    ' Implement custom application error handling here.
    Throw New ApplicationException(String.Format( _
     "A snapshot could not be generated for the {0} publication." _
     , publicationName), ex)
End Try