PopulateFromTemplate 方法

应据其设置数据库的基于模板的作用域说明。

命名空间:  Microsoft.Synchronization.Data.SqlServer
程序集:  Microsoft.Synchronization.Data.SqlServer(在 Microsoft.Synchronization.Data.SqlServer.dll 中)

语法

声明
Public Sub PopulateFromTemplate ( _
    scopeName As String, _
    templateName As String _
)
用法
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
)

参数

注释

模板用于描述基于参数的经过筛选的作用域。随后通过使用 PopulateFromTemplate 检索模板说明以及通过为该模板中描述的参数定义特定值,创建经过筛选的作用域。

示例

下面的示例为一个筛选器定义参数值,将该筛选器应用于服务器数据库,并且使用经过筛选的作用域设置客户端数据库以便准备进行同步。

// 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()

请参阅

参考

SqlSyncScopeProvisioning类

SqlSyncScopeProvisioning 成员

Microsoft.Synchronization.Data.SqlServer 命名空间

其他资源

如何为数据库同步筛选数据 (SQL Server)