PopulateFromTemplate méthode

Article
08/18/2010

Définit la description de l'étendue basée sur un modèle à partir de laquelle la base de données doit être approvisionnée.

Espace de noms : Microsoft.Synchronization.Data.SqlServer
Assembly : Microsoft.Synchronization.Data.SqlServer (dans Microsoft.Synchronization.Data.SqlServer.dll)

Syntaxe

'Déclaration
Public Sub PopulateFromTemplate ( _
    scopeName As String, _
    templateName As String _
)
'Utilisation
Dim instance As SqlSyncScopeProvisioning
Dim scopeName As String
Dim templateName As String

instance.PopulateFromTemplate(scopeName, _
    templateName)

public void PopulateFromTemplate(
    string scopeName,
    string templateName
)

public:
void PopulateFromTemplate(
    String^ scopeName, 
    String^ templateName
)

member PopulateFromTemplate : 
        scopeName:string * 
        templateName:string -> unit

public function PopulateFromTemplate(
    scopeName : String, 
    templateName : String
)

Paramètres

scopeName
Type : System. . :: . .String
Nom de l'étendue.

templateName
Type : System. . :: . .String
Nom du modèle.

Notes

Les modèles sont utilisés pour décrire une étendue filtrée basée sur des paramètres. Une étendue filtrée est alors créée à l'aide de PopulateFromTemplate pour récupérer la description du modèle et à l'aide de valeurs spécifiques pour les paramètres décrits dans le modèle.

Exemples

L'exemple suivant définit la valeur de paramètre d'un filtre, l'applique à la base de données serveur et approvisionne la base de données client avec l'étendue filtrée afin de la préparer pour la synchronisation.

// Create a synchronization scope for retail customers.
// This action adds rows to synchronization tables but does not create new tables or stored procedures, reducing
// the permissions needed on the server.
SqlSyncScopeProvisioning serverProvRetail = new SqlSyncScopeProvisioning(serverConn);
serverProvRetail.ObjectSchema = "Sync";
serverProvRetail.PopulateFromTemplate("RetailCustomers", "customertype_template");
serverProvRetail.Tables["Sales.Customer"].FilterParameters["@customertype"].Value = "Retail";
serverProvRetail.UserDescription = "Customer data includes only retail customers.";
serverProvRetail.Apply();

// Provision the existing database SyncSamplesDb_SqlPeer2 based on filtered scope
// information that is retrieved from the server.
DbSyncScopeDescription clientSqlDesc = SqlSyncDescriptionBuilder.GetDescriptionForScope("RetailCustomers", null, "Sync", serverConn);
SqlSyncScopeProvisioning clientSqlConfig = new SqlSyncScopeProvisioning(clientSqlConn, clientSqlDesc);
clientSqlConfig.ObjectSchema = "Sync";
clientSqlConfig.Apply();

' Create a synchronization scope for retail customers.
' This action adds rows to synchronization tables but does not create new tables or stored procedures, reducing
' the permissions needed on the server.
Dim serverProvRetail As New SqlSyncScopeProvisioning(serverConn)
serverProvRetail.ObjectSchema = "Sync"
serverProvRetail.PopulateFromTemplate("RetailCustomers", "customertype_template")
serverProvRetail.Tables("Sales.Customer").FilterParameters("@customertype").Value = "Retail"
serverProvRetail.UserDescription = "Customer data includes only retail customers."
serverProvRetail.Apply()

' Provision the existing database SyncSamplesDb_SqlPeer2 based on filtered scope
' information that is retrieved from the server.
Dim clientSqlDesc As DbSyncScopeDescription = SqlSyncDescriptionBuilder.GetDescriptionForScope("RetailCustomers", Nothing, "Sync", serverConn)
Dim clientSqlConfig As New SqlSyncScopeProvisioning(clientSqlConn, clientSqlDesc)
clientSqlConfig.ObjectSchema = "Sync"
clientSqlConfig.Apply()