博客园_Life a Poem

Microsoft Sync Framework同步数据库 4：如何为数据库同步筛选数据

2012-03-31T02:20:00Z

如何为数据库同步筛选数据

了解筛选器

我们知道，在为数据库准备同步时，我们需要定义同步作用域来描述同步的数据范围，它是对进行同步的对象的一种逻辑分组。对于数据库同步，一个同步作用域通常是一组数据表。但有时候，我们希望在同步作用域的基础上对同步的数据进行筛选，比如，按照销售人员同步订单数据。这个时候，我们就可以使用Sync Framework的筛选器机制来对同步数据进行筛选。

Sync Framework 可以创建两种类型的筛选器：“静态筛选器”和“基于参数的筛选器”。

静态筛选器定义为同步作用域的一部分，并且定义筛选字段的值。静态筛选器在源数据库使用的存储过程中进行编码，以便为作用域枚举变更。定义了某一静态筛选器后，就不能对其进行更改。在本篇的设置数据库一节中，我们已经定义了一个静态筛选器的完整示例。

基于参数的筛选器由一个筛选子句以及映射到同步作用域中表的列的一组参数定义。基于参数的筛选器在两个阶段中定义。第一个阶段定义筛选子句和参数，并且建立与该筛选器相关联的作用域的说明。在这个阶段中，筛选器和作用域仅采用模板格式。第二个阶段为筛选器设置参数值并且根据模板创建同步作用域。在此阶段中创建的作用域是目标提供程序用来与源数据库同步的作用域。用于基于参数的筛选的源数据库可以是 SQL Server 或 SQL Azure 数据库，目标数据库可以是 SQL Server、SQL Azure 或 SQL Server Compact 数据库。

在针对筛选的典型方案中，数据库管理员或应用程序开发人员定义基于参数的筛选器并且为筛选的同步准备服务器数据库。数据库管理员或应用程序开发人员还可以创建简单工具（例如基于 Web 的订阅工具），该工具使用 Sync Framework 对象以便让用户指定其筛选参数值并为同步订阅其客户端数据库。通过创建订阅工具，该数据库管理员不必为单独的用户创建筛选器，而是用户使用该工具指定适合自己的参数值，并且根据需要订阅同步。

创建基于参数的筛选器

通过两个步骤创建基于参数的筛选器。首先，定义筛选器和作用域模板。然后，创建一个经过筛选的作用域，该作用域具有针对筛选器参数的特定值。这个由两个步骤构成的过程具有以下优势：

易于设置。筛选器模板只需定义一次。
易于订阅。客户端指定要创建的参数值并且根据需要订阅经过筛选的作用域。
易于维护。即使在合并若干参数并且创建许多经过筛选的作用域时，维护工作也很简单，因为使用基于参数的单一过程来枚举变更。

定义筛选器模板

创建基于参数的筛选器的第一个步骤是定义一个筛选器模板，以后可以使用该模板创建经过筛选的作用域。筛选器模板存储在源数据库中并且要求创建同步表和存储过程。因此，在源数据库中需要适当的权限。

筛选器模板与同步作用域一起定义。按如下所示为作用域中的表定义筛选器模板：

通过使用 AddFilterColumn，向同步作用域中的 SqlSyncTableProvisioning 对象添加一个筛选器列。这会将该筛选器列添加到用于跟踪基表变更的跟踪表。
通过将 SqlParameter 对象添加到 SqlSyncTableProvisioning 对象的 FilterParameters 集合，定义一个或多个筛选参数。这会将指定的参数添加到在同步过程中枚举变更的存储过程的参数列表中。
添加一个筛选子句，该子句通过设置 SqlSyncTableProvisioning 对象的 FilterClause 属性，定义参数值和列值之间的关系。筛选子句是不带 WHERE 关键字的 WHERE 子句。[side] 别名是该跟踪表的别名。这些参数匹配在 FilterParameters 集合中指定的参数。此时，您只是定义筛选器参数和列之间的关系。以后在创建经过筛选的作用域时将指定参数的实际值。

然后，通过使用 SqlSyncScopeProvisioning 对象的 Apply 方法将筛选器模板和作用域模板应用于源数据库，此时创建适当的同步表和存储过程。

在筛选子句中，别名 [base] 和 [side] 由 Sync Framework 定义。[base] 指代表的基名称，[side] 指代变更跟踪表。例如，基于 CustomerType 列筛选 Customer 表。默认情况下，[base] 是 [Customer] 的别名，[side] 是 [Customer_tracking] 的别名。由于 CustomerType 列在基表和跟踪表中都存在，在筛选子句中必须限定对它的引用，否则会引起歧义，出现错误。还可以使用实际表来替代 [base] 和 [side] 别名，如 [Customer_tracking].[CustomerType] = @customertype。

下面的示例定义一个筛选器模板并且将其应用于源数据库：

1 // 创建同步作用域模板customertype_template，向其添加两个表
2 DbSyncScopeDescription scopeDesc = new DbSyncScopeDescription("customertype_template");
3 // 设置一个易于理解的注释
4 scopeDesc.UserComment = "Template for Customer and CustomerContact tables. Customer data is filtered by CustomerType parameter.";
5
6 // 定义作用域中的表
7 DbSyncTableDescription customerDescription = SqlSyncDescriptionBuilder.GetDescriptionForTable("Sales.Customer", serverConn);
8 scopeDesc.Tables.Add(customerDescription);
9 DbSyncTableDescription customerContactDescription = SqlSyncDescriptionBuilder.GetDescriptionForTable("Sales.CustomerContact", serverConn);
10 scopeDesc.Tables.Add(customerContactDescription);
11
12 // 创建数据库设置对象以创建同步作用域模板
13 SqlSyncScopeProvisioning serverTemplate = new SqlSyncScopeProvisioning(serverConn, scopeDesc, SqlSyncScopeProvisioningType.Template);
14 serverTemplate.ObjectSchema = "Sync";
15
16 // 为Customer表指定用于过滤数据的列
17 // 为变更跟踪表设置过滤子句，[side]是变更跟踪表的别名
18 // 并且指定过滤参数
19 serverTemplate.Tables["Sales.Customer"].AddFilterColumn("CustomerType");
20 serverTemplate.Tables["Sales.Customer"].FilterClause = "[side].[CustomerType] = @customertype";
21 SqlParameter param = new SqlParameter("@customertype", SqlDbType.NVarChar, 100);
22 serverTemplate.Tables["Sales.Customer"].FilterParameters.Add(param);
23
24 serverTemplate.Apply();

创建经过筛选的作用域

在某一客户端可以使用筛选器与服务器同步前，该客户端必须首先为筛选器参数定义特定值。这个步骤将通过服务器上的筛选器模板来创建经过筛选的作用域，并将此筛选的作用域应用于服务器。

在对服务器数据库指定了经过筛选的作用域后，我们就可以通过调用 GetDescriptionForScope 以便获取该作用域，然后将该作用域应用于客户端数据库，对客户端数据库进行设置。

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

1 // 为retail customers创建同步作用域"RetailCustomers"，并且设置服务器数据库
2 SqlSyncScopeProvisioning serverProvRetail = new SqlSyncScopeProvisioning(serverConn);
3 serverProvRetail.ObjectSchema = "Sync";
4 serverProvRetail.PopulateFromTemplate("RetailCustomers", "customertype_template");
5 serverProvRetail.Tables["Sales.Customer"].FilterParameters["@customertype"].Value = "Retail";
6 serverProvRetail.UserComment = "Customer data includes only retail customers.";
7 serverProvRetail.Apply();
8
9 // 通过上面创建的同步作用域"RetailCustomers"来设置客户端数据库
10 DbSyncScopeDescription clientSqlDesc = SqlSyncDescriptionBuilder.GetDescriptionForScope("RetailCustomers", null, "Sync", serverConn);
11 SqlSyncScopeProvisioning clientSqlConfig = new SqlSyncScopeProvisioning(clientSqlConn, clientSqlDesc);
12 clientSqlConfig.ObjectSchema = "Sync";
13 clientSqlConfig.Apply();

使用筛选作用域同步客户端

在定义了经过筛选的作用域并且设置了客户端数据库后，可以通过在客户端和服务器数据库中为经过筛选的作用域创建 SqlSyncProvider 对象、将提供程序与 SyncOrchestrator 对象相关联和调用 Synchronize 方法，同步客户端。

下面的示例执行两个数据库的筛选同步：

1 SyncOrchestrator syncOrchestrator = new SyncOrchestrator();
2 syncOrchestrator.LocalProvider = new SqlSyncProvider("RetailCustomers", clientSqlConn, null, "Sync");
3 syncOrchestrator.RemoteProvider = new SqlSyncProvider("RetailCustomers", serverConn, null, "Sync");
4 SyncOperationStatistics syncStats = syncOrchestrator.Synchronize();

订阅同步

从上面的介绍中我们可以看到，使用同步作用域模板来同步某一客户端数据库的过程包括：定义筛选器参数值、创建筛选器作用域并应用于服务器数据库以及设置客户端数据库。试想，如果我们需要为每个不同的参数值来创建筛选器作用域、设置服务器数据库、设置客户端数据库，那将会一件非常无聊而繁重的任务。当然，我们可以想出相应的解决方案，来让这些步骤自动化，这个解决方案就是创建同步订阅服务。

用于定义筛选器参数值、将新指定的筛选器应用于服务器数据库以及设置客户端数据库的代码可以轻松地封装在单独的工具中，该工具收集来自某一用户的筛选器参数值并且为筛选的同步订阅该用户的客户端数据库。请参阅下面的步骤来完成一个简单的同步订阅服务：

准备数据库

请参阅“同步数据库示例：同步 SQL Server 和 SQL Server Compact” 一篇的“创建示例服务器数据库”一节来创建SyncDB数据库

定义筛选器模板

运行下面的程序来定义一个筛选器模板

1 // 测试同步订阅之前，请使用此方法先在服务器数据库中创建同步作用域模板
2 static void CreateSyncTemplateOnServer()
3 {
4 string ServerConnectionString = "Data Source=localhost; Initial Catalog=SyncDB; Integrated Security=True";
5 using (var serverConn = new SqlConnection(ServerConnectionString))
6 {
7 //定义筛选同步作用域OrdersScope-NC
8 DbSyncScopeDescription scopeDesc = new DbSyncScopeDescription("OrdersScope_Template");
9
10 //从SyncDB 服务器数据库检索Orders表的架构并添加至同步作用域
11 DbSyncTableDescription tableDesc = SqlSyncDescriptionBuilder.GetDescriptionForTable("Orders", serverConn);
12 scopeDesc.Tables.Add(tableDesc);
13
14 //创建一个同步设置对象
15 SqlSyncScopeProvisioning serverProvision = new SqlSyncScopeProvisioning(serverConn, scopeDesc, SqlSyncScopeProvisioningType.Template);
16 serverProvision.Tables["Orders"].AddFilterColumn("OriginState");
17 serverProvision.Tables["Orders"].FilterClause = "[side].[OriginState] = @originState";
18 SqlParameter param = new SqlParameter("@originState", SqlDbType.NVarChar, 2);
19 serverProvision.Tables["Orders"].FilterParameters.Add(param);
20
21 // 开始设置过程
22 serverProvision.Apply();
23 }
24 }

创建同步订阅服务

新建一个WCF Service Application，创建的订阅服务如下：

1 /// <summary>
2 /// Subscribe Sync Scope for Client
3 /// Create Sync Scope from Sync Scope Template, then Provision the server database, then Provision the client database.
4 /// </summary>
5 /// <param name="ScopeTemplateName"></param>
6 /// <param name="SyncObjectSchema"></param>
7 /// <param name="FilterParameters"></param>
8 /// <returns></returns>
9 public string SubscribeSyncScopeForClient(string ScopeTemplateName, string SyncObjectSchema, List<SyncScopeParameter> FilterParameters, string clientConnectionString)
10 {
11 //1. 生成客户端ScopeName, 依据传入的Scope Template Name外加Guid生成，确保唯一性
12 Guid clientId = Guid.NewGuid();
13 string _clientScopeName = String.Format(CultureInfo.InvariantCulture, "{0}_{1}", ScopeTemplateName, clientId);
14
15 //2. 设置服务器端数据库
16 //2.1 设置服务器端连接字符串，本例中将对SyncDB数据库进行设置
17 string ServerConnectionString = "Data Source=localhost; Initial Catalog=SyncDB; Integrated Security=True";
18 using (var serverConnection = new SqlConnection(ServerConnectionString))
19 {
20 var provisioning = new SqlSyncScopeProvisioning(serverConnection);
21
22 //如果需要设置同步架构名称
23 if (!String.IsNullOrEmpty(SyncObjectSchema))
24 {
25 provisioning.ObjectSchema = SyncObjectSchema;
26 }
27
28 //判断传入的ScopeName是否是同步作用域模板
29 if (!provisioning.TemplateExists(ScopeTemplateName))
30 {
31 throw new Exception(string.Format("No scope temple '{0}' found in server database.", ScopeTemplateName));
32 }
33
34 provisioning.PopulateFromTemplate(_clientScopeName, ScopeTemplateName);
35 //处理过滤参数
36 if (null != FilterParameters && 0 != FilterParameters.Count)
37 {
38 foreach (var param in FilterParameters)
39 {
40 provisioning.Tables[param.TableName].FilterParameters[param.ParameterName].Value = param.ParameterValue;
41 }
42 }
43 //同步服务器
44 if (!provisioning.ScopeExists(_clientScopeName))
45 {
46 provisioning.Apply();
47 }
48 //设置客户端数据库，此处假设客户端数据库类型为Sql Server数据库
49 using (var clientConnection = new SqlConnection(clientConnectionString))
50 {
51 DbSyncScopeDescription scopeDesc = SqlSyncDescriptionBuilder.GetDescriptionForScope(_clientScopeName, serverConnection);
52 SqlSyncScopeProvisioning clientProvision = new SqlSyncScopeProvisioning(clientConnection, scopeDesc);
53 clientProvision.Apply();
54 }
55 return _clientScopeName;
56 }
57 }

调用同步订阅服务

新建一个Console Application客户端程序来测试该同步订阅服务，关键代码如下：

1 static void Main(string[] args)
2 {
3 //准备服务参数
4 string scopeTemplateName = "OrdersScope_Template";
5 List<ServiceReference1.SyncScopeParameter> list = new List<ServiceReference1.SyncScopeParameter>();
6 list.Add(new ServiceReference1.SyncScopeParameter() { TableName = "Orders", ParameterName = "@originState", ParameterValue = "WA" });
7 string clientConnectionString = @"Data Source=localhost; Initial Catalog=SyncDB2; Integrated Security=True";
8 //调用同步订阅服务
9 string clientScopeName = (new ServiceReference1.DatabaseSyncSubscriberClient())
10 .SubscribeSyncScopeForClient(scopeTemplateName, null, list.ToArray(), clientConnectionString);
11
12 Console.WriteLine("Both server and client databases are provisioned for scope {0}", clientScopeName);
13 }

完整的项目源代码请点击这里下载。

本文链接

Microsoft Sync Framework同步数据库 3：针对同步进行设置

2012-03-12T08:03:00Z

针对同步进行设置

在可以使用 Sync Framework 同步数据库之前，需要通过称为“设置（provisioning）”的流程配置它。所需的设置类型因数据库类型而异。本篇提供有关设置 SQL Server 和 SQL Server Compact 数据库的背景信息、操作步骤以及完整代码示例。

了解设置和取消设置(Provision and Deprovision)

为同步配置数据库的第一步是定义一个作用域，该作用域标识要同步的内容。在您定义同步作用域后，就可以使用该同步作用域来设置数据库，以便创建变更跟踪和元数据管理基础结构，该基础结构由元数据表、触发器和存储过程构成。在设置了某一数据库后，可以通过使用某一提供程序（例如 SqlSyncProvider）来表示该数据库和使用 SyncOrchestrator 对象管理同步会话并连接到其他同步提供程序以实现数据同步。为同步设置数据库是有别于与其他数据库同步的单独任务，这部分代码通常位于单独的应用程序中。

设置(Provision)

在设置(Provision)数据库时，通常会在数据库中创建以下某些或全部元素：

在同步作用域中包含的基表。
作用域中每个基表的一个跟踪表。该跟踪表跟踪对关联基表进行的变更。
在直接对基表进行更改时更新跟踪表的触发器。
用于同步操作的存储过程，例如枚举变更、插入变更、更新数据或删除数据。通过设置对象的SetUseBulkProceduresDefault方法可以为SQL Server 2008 和 SQL Azure 数据库创建使用表值函数一次执行多行的插入、更新和删除操作的成批过程。
包含同步作用域信息的特殊表，例如 scope_info 表。如果这些表尚不存在，则创建这些表。

数据库设置对象提供了相应方法来控制上面这些同步元素的创建，比如：基表创建由 SetCreateTableDefault 方法控制，跟踪表创建由 SetCreateTrackingTableDefault 方法控制。此外，同步元素可以创建在数据库的单独架构（Schema）中，这是通过 SqlSyncScopeProvisioning类的ObjectSchema 属性实现的。

可通过调用 SqlSyncScopeProvisioning.Apply 或 SqlCeSyncScopeProvisioning.Apply方法直接应用设置；或者，对于 SQL Server 数据库，可以创建一个脚本并在以后运行该脚本来设置数据库。若要创建设置脚本，请调用 SqlSyncScopeProvisioning.Script 方法。

取消设置(Deprovision)

如果您不再需要某一作用域，则可以通过调用SqlSyncScopeDeprovisioning.DeprovisionScope 或 SqlCeSyncScopeDeprovisioning.DeprovisionScope，删除该作用域及其关联的元数据表、触发器和存储过程。在已删除某一作用域后，该作用域不再用于同步。如果某一数据库元素（例如元数据表）由多个作用域使用，则在使用该元素的最后一个作用域被删除前，将不删除该元素。例如，您具有名为 Customers 的一个表，并且定义两个分别名为 RetailCustomers 和 WholesaleCustomers 的作用域，并且这两个作用域包含 Customers 表。在您删除 WholesaleCustomers 作用域时，用于 Customers 表的元数据表不删除，因为它仍由 RetailCustomers 作用域使用。

如果您使用基于参数的筛选器来筛选 SQL Server 或 SQL Azure 数据库中的同步数据，则首先创建一个筛选器模板，然后基于该筛选器模板创建筛选的作用域。您还可以通过调用 DeprovisionTemplate，轻松地删除该筛选器模板和基于该模板创建的所有经过筛选的作用域，以及所有关联的元数据表、触发器和存储过程。例如，您创建一个 customerstate_template 模板，该模板通过使用 state 参数进行筛选。您基于 customerstate_template 创建两个经过筛选的作用域 customers_WA 和 customers_OR。在您删除 customerstate_template 时，customers_WA 和 customers_OR 也删除。

您还可以通过调用SqlSyncScopeDeprovisioning.DeprovisionStore 或 SqlCeSyncScopeDeprovisioning.DeprovisionStore，从数据库中删除所有作用域和筛选器以及所有同步元数据表、触发器和存储过程。此外，因为删除单独的作用域和筛选器模板将仅删除作用域级别和模板级别的元数据，而不删除数据库级别的元数据，所以，SqlSyncScopeDeprovisioning.DeprovisionStore 或 SqlCeSyncScopeDeprovisioning.DeprovisionStore 可用于在删除了所有作用域和模板后清除剩余的同步元数据表。

设置数据库

同步作用域和同步模板

我们之前已经了解到，同步作用域是对进行同步的对象的一种逻辑分组。对于数据库同步，一个同步组通常是一组数据表，并且数据表可以被过滤。同时一个数据表可以被包含在一个或多个同步组中。

有些时候，我们需要使用基于参数的筛选器来筛选 SQL Server 或 SQL Azure 数据库中的同步数据，则首先创建一个筛选器模板，然后基于该筛选器模板创建筛选的作用域。比如，每个销售人员只对自己相关的订单数据感兴趣，那么我们就需要针对每个销售人员创建同步作用域，这时，我们就可以使用同步模板来简化同步作用域的创建过程，甚至通过订阅的手段来实现这一过程的自动化。关于筛选器模板的详细介绍请参考下篇“如何为数据库同步筛选数据”。

定义同步作用域

下面的代码定义了一个名为filtered_customer 的同步作用域，并为其添加了两个表：Customer和CustomerContact。因为这些表已经存在于服务器数据库之中，所以使用GetDescriptionForTable方法来检索表的架构。Customer表的所有列都包含在同步作用域中，但是CustomerContact表只包含了两列。

DbSyncScopeDescription scopeDesc = new DbSyncScopeDescription("filtered_customer");

// Definition for Customer.
DbSyncTableDescription customerDescription =
SqlSyncDescriptionBuilder.GetDescriptionForTable("Sales.Customer", serverConn);

scopeDesc.Tables.Add(customerDescription);

// Definition for CustomerContact, including the list of columns to include.
Collection<string> columnsToInclude = new Collection<string>();
columnsToInclude.Add("CustomerId");
columnsToInclude.Add("PhoneType");
DbSyncTableDescription customerContactDescription =
SqlSyncDescriptionBuilder.GetDescriptionForTable("Sales.CustomerContact", columnsToInclude, serverConn);

scopeDesc.Tables.Add(customerContactDescription);

设置服务器数据库

下面的代码为filtered_customer 同步作用域创建了一个设置对象，并且指定所有同步元素创建在"Sync"数据库架构中。代码还为Customer表指定了一个过滤条件，只有满足该条件的数据行才会被同步。定义一个过滤条件分为两部分：调用AddFilterColumn指定过滤列名为”CustomerType”，它会被添加到变更跟踪表以跟踪Customer表的改变。调用FilterClause指定过滤条件本身，它是不包含WHERE关键字的WHERE子句。[side]是变更跟踪表的别名。定义好设置选项后，Apply方法会在服务器数据库中创建变更跟踪基础结构，并且把设置脚本写到一个文件中。

SqlSyncScopeProvisioning serverConfig = new SqlSyncScopeProvisioning(serverConn, scopeDesc);
serverConfig.ObjectSchema = "Sync";

// Specify which column(s) in the Customer table to use for filtering data,
// and the filtering clause to use against the tracking table.
// "[side]" is an alias for the tracking table.
serverConfig.Tables["Sales.Customer"].AddFilterColumn("CustomerType");
serverConfig.Tables["Sales.Customer"].FilterClause = "[side].[CustomerType] = 'Retail'";

// Configure the scope and change-tracking infrastructure.
serverConfig.Apply();

// Write the configuration script to a file. You can modify
// this script if necessary and run it against the server
// to customize behavior.
File.WriteAllText("SampleConfigScript.txt", serverConfig.Script());

设置客户端数据库

我们可以通过两种方式来设置客户端数据库：

1．基于从服务器或另外的客户端数据库获取的scope/作用域信息，完全初始化一个SQL Server或SQL Server Compact客户端数据库。我们可以通过SqlSyncDescriptionBuilder和SqlCeSyncDescriptionBuilder对象来获取同步作用域的架构信息，从而在客户端数据库创建同步对象。

2．通过一个已经存在的客户端数据库来对一个SQL Server Compact客户端数据库进行快照初始化。

快照初始化的主要目的是减少初始化客户端数据库所需的时间。更多关于快照初始化的知识请参照本篇“使用快照设置数据库”的详细介绍。

下面的代码示例首先从服务器获取同步作用域信息，并使用它们来设置一个SQL Server Compact客户端数据库。然后，基于该SQL Server Compact客户端数据库的作用域信息来设置另一个SQL Server客户端数据库。

// 创建一个SQL Server Compact数据库并用从服务器端获取的作用域信息来设置它
// Compact数据库不支持单独的schema，
// 所以我们通过为所有的同步对象增加前缀"Sync"来使他们易于区分
Utility.DeleteAndRecreateCompactDatabase(Utility.ConnStr_SqlCeSync1, true);
Utility.DeleteAndRecreateCompactDatabase(Utility.ConnStr_SqlCeSync2, false);
DbSyncScopeDescription clientSqlCe1Desc = SqlSyncDescriptionBuilder.GetDescriptionForScope("filtered_customer", null, "Sync", serverConn);
SqlCeSyncScopeProvisioning clientSqlCe1Config = new SqlCeSyncScopeProvisioning(clientSqlCe1Conn, clientSqlCe1Desc);
clientSqlCe1Config.ObjectPrefix = "Sync";
clientSqlCe1Config.Apply();

// 通过从SQL Server Compact数据库中获取的同步作用域信息来设置一个SQL Server客户端数据库
// 当然我们也可以从服务器端获取作用域信息
DbSyncScopeDescription clientSqlDesc = SqlCeSyncDescriptionBuilder.GetDescriptionForScope("filtered_customer", "Sync", clientSqlCe1Conn);
SqlSyncScopeProvisioning clientSqlConfig = new SqlSyncScopeProvisioning(clientSqlConn, clientSqlDesc);
clientSqlConfig.ObjectSchema = "Sync";
clientSqlConfig.Apply();

取消设置数据库

下面的代码示例为我们展示了如何：

在客户端数据库中取消设置一个同步作用域
在服务器数据库中取消设置筛选器模板和相关的作用域
完全取消设置一个客户端数据库，这样所有的同步对象都会被删除

删除一个作用域

下面的示例在一个SQL Server客户端数据库中删除RetailCustomers作用域。同时，删除作用域的脚本被保存到了一个文件之中，这个脚本可以用来执行以删除其他数据库中的RetailCustomers作用域。淡然，这个步骤对于删除一个同步作用域来说是可选的。

// 在SQL Server客户端数据库中删除RetailCustomers作用域
SqlSyncScopeDeprovisioning clientSqlDepro = new SqlSyncScopeDeprovisioning(clientSqlConn);

// 首先把取消设置的SQL脚本保存下来，以便取消设置其他的SQL Server客户端数据库
// 这一步是可选的
File.WriteAllText("SampleDeprovisionScript.txt",
clientSqlDepro.ScriptDeprovisionScope("RetailCustomers"));

// 删除作用域
clientSqlDepro.DeprovisionScope("RetailCustomers");

删除一个筛选器模板

在删除一个筛选器模板之前，我们通常需要查看从这个筛选器模板创建出来的同步作用域，因为当这个筛选器模板被删除（Deprovision）时，所有这些作用域也会被删除。下面的SQL脚本可以用来查找由customertype_template筛选器模板所创建的筛选作用域。

-- Find all filtered scopes that were created from the filtered scope template named 'customertype_template'.

select sync_scope_name from scope_info
where scope_config_id =
(select template_config_id from scope_templates
where template_name = N'customertype_template')

下面的示例从SQL Server服务器数据库中删除customertype_template筛选器模板。在删除该模板的同时也会删除由它创建出来的作用域RetailCustomers和WholesaleCustomers。

// 从服务器数据库中删除"customertype_template"模板
// 这样也会删除所有依赖与该模板的作用域
SqlSyncScopeDeprovisioning serverSqlDepro = new SqlSyncScopeDeprovisioning(serverConn);
serverSqlDepro.DeprovisionTemplate("customertype_template");

删除所有同步对象

下面的示例从一个SQL Server Compact客户端数据库中删除所有的同步对象，包括：同步元数据表、触发器和存储过程。

// 在SQL Server Compact数据库这哦你删除所有的同步对象
SqlCeSyncScopeDeprovisioning clientSqlCeDepro = new SqlCeSyncScopeDeprovisioning(clientSqlCe1Conn);
clientSqlCeDepro.DeprovisionStore();

使用快照设置数据库

如果我们需要对多个SQL Server Compact数据库的同步进行设置，那么我们可以使用数据库快照来减少初始化所需的时间。一个快照是特别准备的，包含了表架构、数据（可选）、和变更跟踪基础结构的SQL Server Compact数据库。在我们对一个SQL Server Compact数据库作完全初始化后，我们可以为其创建一个快照，该快照可以拷贝至其他需要同步的SQL Server Compact数据库。对数据库应用快照的过程比完全初始化要高效得多。

下面的示例为我们展示了通过从服务器数据库获取的作用域信息来设置Compact数据库，然后使用该数据库的快照来初始化另外一个数据库。

static void SynchronizationUsingSnapshot()
{
// 通过从服务器数据库获取的作用域信息来设置Compact数据库SyncCompactDB2.sdf
SqlCeConnection clientConn = new SqlCeConnection(@"Data Source='D:\Sync Framework\CompactDB\SyncCompactDB2.sdf'");
SqlConnection serverConn = new SqlConnection("Data Source=localhost; Initial Catalog=SyncDB; Integrated Security=True");
DbSyncScopeDescription scopeDesc = SqlSyncDescriptionBuilder.GetDescriptionForScope("ProductsScope", serverConn);
SqlCeSyncScopeProvisioning clientProvision = new SqlCeSyncScopeProvisioning(clientConn, scopeDesc);
clientProvision.Apply();

// 从SQL Server Compact数据库创建一个快照，该快照将用于初始化其他的Compact数据库
// 尽管我们可以从其他数据库获取作用域信息来初始化，但快照的使用为Compact数据库提供了一个更加快捷方便的部署方案。
// SyncCompactDB3.sdf为不存在的Compact数据库，将在GenerateSnapshot方法中自动创建
string newCompactDB = @"D:\Sync Framework\CompactDB\SyncCompactDB3.sdf";
SqlCeSyncStoreSnapshotInitialization syncStoreSnapshot = new SqlCeSyncStoreSnapshotInitialization();
syncStoreSnapshot.GenerateSnapshot(clientConn, newCompactDB);

// 对使用快照初始化的SyncCompactDB3.sdf执行同步,因为快照中已经包含了服务器中的数据
// 所以本次同步将没有数据被同步，直到一方的数据发生变化
SyncOrchestrator syncOrchestrator = new SyncOrchestrator();
syncOrchestrator.LocalProvider = new SqlCeSyncProvider("ProductsScope", clientConn);
syncOrchestrator.RemoteProvider = new SqlSyncProvider("ProductsScope", serverConn);
syncOrchestrator.Direction = SyncDirectionOrder.UploadAndDownload;
SyncOperationStatistics syncStats = syncOrchestrator.Synchronize();
DisplayStats(syncStats);
}

static void DisplayStats(SyncOperationStatistics syncStats)
{
// 输出统计数据
Console.WriteLine("Start Time: " + syncStats.SyncStartTime);
Console.WriteLine("Total Changes Uploaded: " + syncStats.UploadChangesTotal);
Console.WriteLine("Total Changes Downloaded: " + syncStats.DownloadChangesTotal);
Console.WriteLine("Complete Time: " + syncStats.SyncEndTime);
Console.WriteLine(String.Empty);
}

本文链接

Microsoft Sync Framework同步数据库 2：同步SQL Server和SQL Server Compact示例

2012-03-09T05:44:00Z

同步SQL Server和SQL Server Compact示例

本篇文章通过使用 Sync Framework同步数据库的一个完整示例讲述了执行常见同步任务的操作步骤。该示例旨在说明如何通过使用 Sync Framework 同步 SQL Server 数据库（包括 SQL Server Express 和 SQL Server Compact）。

创建示例服务器数据库

这里，我们将创建一个示例 SQL Server 数据库，以后在同步应用场景中将会使用该数据库。下面是创建该数据库的详细步骤：

1．启动SQL Server Management Studio（SSMS），连接到SQL Server服务器。

2．新建一个查询，输入并运行一下SQL脚本：

USE [master]
GO

IF EXISTS(SELECT name FROM sys.databases WHERE name = 'SyncDB')
DROP DATABASE SyncDB

CREATE DATABASE [SyncDB]
GO

USE [SyncDB]
GO

CREATE TABLE [dbo].[Products](
[ID] [int] NOT NULL,
[Name] [nvarchar](50) NOT NULL,
[ListPrice] [money] NOT NULL

CONSTRAINT [PK_Products] PRIMARY KEY CLUSTERED ([ID] ASC)
)
GO

CREATE TABLE [dbo].[Orders](
[OrderID] [int] NOT NULL,
[ProductID] [int] NOT NULL,
[Quantity] [int] NOT NULL,
[OriginState] [nvarchar](2) NOT NULL,
CONSTRAINT [PK_Orders] PRIMARY KEY CLUSTERED ([OrderID] ASC,[ProductID] ASC)
)
GO

ALTER TABLE [dbo].[Orders] WITH CHECK ADD CONSTRAINT [FK_Orders_Products] FOREIGN KEY([ProductID])
REFERENCES [dbo].[Products] ([ID])
GO

ALTER TABLE [dbo].[Orders] CHECK CONSTRAINT [FK_Orders_Products]
GO

INSERT INTO Products VALUES (1, 'PC', 400)
INSERT INTO Products VALUES (2, 'Laptop', 600)
INSERT INTO Products VALUES (3, 'NetBook', 300)

INSERT INTO Orders VALUES (1, 1, 2, 'NC')
INSERT INTO Orders VALUES (2, 2, 1, 'NC')
INSERT INTO Orders VALUES (3, 1, 5, 'WA')
INSERT INTO Orders VALUES (3, 3, 10, 'WA')
INSERT INTO Orders VALUES (4, 2, 4, 'WA')

定义作用域和设置服务器

为使服务器数据库做好同步准备，您将需要描述同步作用域并使用与作用域相关的项目来设置服务器数据库。

通过描述同步作用域来定义要同步的内容。同步作用域是必须作为一个单元来同步的一组表。同步作用域中的表可以已存在于数据库中；也可以通过使用 Sync Framework 对象模型描述这些表，然后在设置基础存储区时在运行时生成它们。这里我们将使用服务器数据库中已存在的 Products 表。

数据库设置涉及将与同步作用域相关的项目（例如跟踪表、触发器和存储过程）添加到数据库。这些项目由同步过程在运行时使用。在这个演练中，我们将创建一个控制台应用程序，该应用程序定义名为 ProductsScope 的同步作用域（包括 Products 表），并且使用与同步作用域相关的项目设置在上一步中创建的 SQL Server 数据库。

1．打开Visual Studio 2008/2010，新建一个控制台应用程序ProvisionServer。并为“解决方案名称”键入 SyncSQLServerAndSQLCompact。

2．添加对Microsoft.Synchronization.Data 和 Microsoft.Synchronization.Data.SqlServer程序集的引用。

3．按下面的代码完成该控制台应用程序：

using System.Data.SqlClient;
using Microsoft.Synchronization.Data;
using Microsoft.Synchronization.Data.SqlServer;

namespace ProvisionServer
{
class Program
{
static void Main(string[] args)
{
//创建数据库连接
SqlConnection serverConn = new SqlConnection("Data Source=localhost; Initial Catalog=SyncDB; Integrated Security=True");

//定义同步作用域ProductsScope
DbSyncScopeDescription scopeDesc = new DbSyncScopeDescription("ProductsScope");

//从SyncDB 服务器数据库检索Products表的架构
DbSyncTableDescription tableDesc = SqlSyncDescriptionBuilder.GetDescriptionForTable("Products", serverConn);

//向同步作用域中添加同步表的描述
scopeDesc.Tables.Add(tableDesc);

//创建一个同步作用域设置对象
SqlSyncScopeProvisioning serverProvision = new SqlSyncScopeProvisioning(serverConn, scopeDesc);

//如果表已经存在则略过创建表的步骤
serverProvision.SetCreateTableDefault(DbSyncCreationOption.Skip);

//开始设置过程
serverProvision.Apply();
}
}
}

4．运行该控制台程序。

5．在SQL Server Management Studio中，依次展开 SyncDB 节点和“表”，此时您应会看到设置过程创建的以下附加表：Products_Tracking、schema_info、scope_config 和 scope_info。还有设置过程创建的其他数据库对象，例如触发器和存储过程。

设置 SQL Compact 客户端

现在，我们将创建一个名为 SyncCompactDB 的 SQL Server Compact 数据库，并且创建一个控制台应用程序，该应用程序使用与 ProductsScope 相关的项目设置该Compact数据库。设置过程将使客户端数据库做好与服务器进行同步的准备。在前一步骤：定义作用域和设置服务器中，您已使用与同步相关的项目设置了服务器数据库。

创建 SQL Server Compact 数据库

1．在SQL Server Management Studio 中，单击“文件”菜单，然后单击“连接对象资源管理器”。

2．在“连接到服务器”对话框中，为“服务器类型”选择 SQL Server Compact Edition。

3．单击“数据库文件”旁边的向下箭头，然后单击“新建数据库”。

4．在“创建新的 SQL Server Compact 数据库”对话框中，为“数据库文件名”键入 C:\SyncSQLServerAndSQLCompact\SyncCompactDB.sdf，然后单击“确定”。

5．在您看到的关于空密码的消息框上单击“是”。

6．在“连接到服务器”对话框中单击“连接”。

设置 SQL Server Compact 数据库

1．在上一步骤中创建的SyncSQLServerAndSQLCompact解决方案中添加一个新的控制台应用程序ProvisionClient。

2．添加对Microsoft.Synchronization、Microsoft.Synchornization.Data、Microsoft.Synchronization.Data.SqlServer、Microsoft.Synchronization.Data.SqlServerCe程序集的引用。

3．添加对 System.Data.SqlServerCe 程序集的引用。

4．按下面的代码完成该控制台应用程序：

using System.Data.SqlClient;
using System.Data.SqlServerCe;

using Microsoft.Synchronization.Data;
using Microsoft.Synchronization.Data.SqlServer;
using Microsoft.Synchronization.Data.SqlServerCe;

namespace ProvisionClient
{
class Program
{
static void Main(string[] args)
{
//创建到SyncCompactDB数据库的连接
SqlCeConnection clientConn = new SqlCeConnection(@"Data Source='D:\Sync Framework\CompactDB\SyncCompactDB.sdf'");

//创建到SyncDB服务器数据库的连接
SqlConnection serverConn = new SqlConnection("Data Source=localhost; Initial Catalog=SyncDB; Integrated Security=True");

//从SyncDB服务器数据库中获取ProductsScope同步作用域
DbSyncScopeDescription scopeDesc = SqlSyncDescriptionBuilder.GetDescriptionForScope("ProductsScope", serverConn);

//基于ProductsScope同步作用域创建CE设置对象
SqlCeSyncScopeProvisioning clientProvision = new SqlCeSyncScopeProvisioning(clientConn, scopeDesc);

//开始设置过程
clientProvision.Apply();
}
}
}

5．运行该控制台程序。

6．在SQL Server Management Studio中，依次展开 SQL Server Compact [My Computer\...\SyncCompactDB] 节点和“表”，此时您应会看到设置过程创建的以下附加表：Products_Tracking、schema_info、scope_config 和 scope_info。还有设置过程创建的其他对象，例如触发器和存储过程。

执行同步

在前面的步骤中，您准备了服务器数据库 SyncDB 和Compact数据库 SyncCompactDB 以便进行同步。现在我们将创建一个控制台应用程序，该控制台应用程序将真正开始这两个数据库之间的同步过程。

1．为SyncSQLServerAndSQLCompact解决方案添加一个新的控制台应用程序，项目名称为ExecuteCompactSync。

2．添加对Microsoft.Synchronization、Microsoft.Synchornization.Data、Microsoft.Synchronization.Data.SqlServer、Microsoft.Synchronization.Data.SqlServerCe程序集的引用。

3．添加对 System.Data.SqlServerCe 程序集的引用。

4．按下面的代码完成该控制台应用程序：

using System;
using System.Data;
using System.Data.SqlClient;
using System.Data.SqlServerCe;

using Microsoft.Synchronization;
using Microsoft.Synchronization.Data;
using Microsoft.Synchronization.Data.SqlServer;
using Microsoft.Synchronization.Data.SqlServerCe;

namespace ExecuteCompactSync
{
class Program
{
static void Main(string[] args)
{
//创建到SyncCompactDB database的连接
SqlCeConnection clientConn = new SqlCeConnection(@"Data Source='D:\Sync Framework\CompactDB\SyncCompactDB.sdf'");

//创建到SyncDB服务器数据库的连接
SqlConnection serverConn = new SqlConnection("Data Source=localhost; Initial Catalog=SyncDB; Integrated Security=True");

//创建同步代理（sync orhcestrator）
SyncOrchestrator syncOrchestrator = new SyncOrchestrator();

//设置同步代理的本地同步提供程序为SyncCompactDB compact database的ProductsScope
syncOrchestrator.LocalProvider = new SqlCeSyncProvider("ProductsScope", clientConn);

//设置同步代理的远程同步提供程序为SyncDB server database的ProductsScope
syncOrchestrator.RemoteProvider = new SqlSyncProvider("ProductsScope", serverConn);

//设置同步会话的同步方向为Upload和Download
syncOrchestrator.Direction = SyncDirectionOrder.UploadAndDownload;

//侦听本地同步提供程序的ApplyChangeFailed事件
((SqlCeSyncProvider)syncOrchestrator.LocalProvider).ApplyChangeFailed += new EventHandler<DbApplyChangeFailedEventArgs>(Program_ApplyChangeFailed);

//执行同步过程
SyncOperationStatistics syncStats = syncOrchestrator.Synchronize();

//输出统计数据
Console.WriteLine("Start Time: " + syncStats.SyncStartTime);
Console.WriteLine("Total Changes Uploaded: " + syncStats.UploadChangesTotal);
Console.WriteLine("Total Changes Downloaded: " + syncStats.DownloadChangesTotal);
Console.WriteLine("Complete Time: " + syncStats.SyncEndTime);
Console.WriteLine(String.Empty);
}

static void Program_ApplyChangeFailed(object sender, DbApplyChangeFailedEventArgs e)
{
//显示冲突类型
Console.WriteLine(e.Conflict.Type);

//显示错误信息
Console.WriteLine(e.Error);
}

}
}

5．在“解决方案资源管理器”中，将ExecuteCompactSync项目设置为启动项目。

6．执行该控制台应用程序，你应该能看到如下输出。可以看到，位于 SyncDB 服务器数据库的 Products 表中的三条记录已经下载到Compact客户端数据库中了，我们可以在SSMS中进行确认。

7．在 SQL Server Management Studio 中，为SyncDB服务器数据库的Products表添加一条记录：（ID=4，Name=” Wireless Mouse”，ListPrice=45）。

8．在 Visual Studio 中，再次执行同步客户端程序。您应该看到如下输出。我们可以在SSMS中确认该条新记录是否已经同步至Compact客户端数据库了。

我们可以通过在服务器/客户端添加/更新/删除记录，反复试验以便熟悉Sync Framework技术。例如，如果您从服务器删除一条记录，则在您下次将客户端与服务器同步时，应该删除客户端数据库中相应的记录。如果在客户端添加记录，同步时也会上传到服务器数据库。

应园友的要求，本解决方案的源代码已经上传，需要的朋友请点此下载。运行时请参照文中的具体步骤与前提条件，比如数据库的创建等。

本文链接

Microsoft Sync Framework同步数据库 1：同步数据库简介

2012-03-09T02:33:00Z

同步数据库简介

概述

Sync Framework 支持在数据库之间进行同步。它提供了一个直观且灵活的 API，使您可以生成面向脱机和协作方案的应用程序。通过该 API，您可以根据应用程序的体系结构和要求，使用所提供的所有或部分组件来完成同步工作。Sync Framework 支持客户端-服务器、客户端到客户端和混合拓扑。在客户端-服务器拓扑中，所有客户端都与某一中央服务器同步。在客户端到客户端拓扑中，每个客户端都可以与其他客户端同步，而变更不必通过中央服务器来传递。混合拓扑由客户端到客户端拓扑和客户端-服务器拓扑组合而成。

传统的分布式系统

随着计算机网路技术的飞速发展，特别是因特网计术的应用与普及，分布式计算机软件已经越来越重要了。毕竟，分布式技术为我们带来了数据共享，使得交互与协作成为可能。对于一家企业来说，能够支持移动和远程工作人员正在变得越来越重要。组织机构应确保这些工作人员能够像在办公室时一样访问到相同的信息，这一点非常重要。在大多数情况下，这些用户将使用便携式计算机、办公台式机、smartphone 或 PDA，远程用户使用这些设备通过网络访问数据仓库。但是这种传统的分布式解决方案存在着如下这些严重缺陷而无法获得满意的效果：

网络要求

若要使用户能够访问信息，远程设备在访问数据时必须能够不间断地连接到公司网络。对于某些工作人员（如在家办公的人员），这可能并不是什么问题。但对于其他用户（如经常出差的销售人员），就可能会比较困难。例如，如果某一销售人员正在拜访客户，并且由于没有网络连接而无法访问库存数据，该销售人员将无法有效地完成工作。

数据访问速度

在典型的客户端-服务器公司环境中，用户拥有可快速访问信息的高速网络。但是，远程工作人员常常通过不太可靠的慢速网络进行连接。在使用典型的解决方案时，每次当用户需要一份数据时，都必须进行下载，因为无法将数据长久地保存到设备上。例如，销售人员每次打开应用程序时，都必须下载其产品列表，而使用信息填充应用程序所需的时间可能非常长，这让用户非常苦恼。

单个故障点

使用这种解决方案时，用户常常依赖于单个服务器数据库。如果数据库由于计划的服务器停机或意外的服务器故障而无法使用，所有远程工作人员与其数据的连接将会中断。

服务器可伸缩性

随着远程工作人员的数量不断增加，公司服务器的性能将会受到影响，并且可能需要添加更多的硬件。

偶尔连接的应用程序

现在对于传统分布式系统解决方案的一种替代方案是实现偶尔连接的应用程序。偶尔连接的应用程序仍使得远程工作人员能够访问数据，但其所需的信息在本地存储。偶尔连接的应用程序通常使用数据同步来填充本地数据库。

数据同步包括以下功能：定期获取存储在一个数据库（如客户端数据库）中的信息并与其他数据库（如服务器数据库）同步变更。基于同步的解决方案的优点在于：用户不再必须使用不间断的网络连接来访问信息。由于将数据存储在本地，用户可以随时访问数据，同时还减轻了中心数据库的处理负载。此外，由于网络速度不再是限制因素，用户现在能够以本地计算机的速度来访问数据。

客户端到客户端同步可避免发生单点故障，因为它使同步不依赖于所有变更均需通过服务器。这种将大量应用程序处理推向每个客户端的功能还有助于解决服务器可伸缩性问题。

是的，正如我们看到的，偶尔连接的应用程序非常适合解决因网络问题不能一直保持连接的程序，并且能改善系统性能，增强可靠性。而我们需要做的就是，需要在本地数据库和远程数据库中进行数据同步。Sync Framework就对数据库同步这种场景提供了优秀和完整的支持，使我们免于自己为每个系统去实现复杂的同步逻辑和异常处理。

Sync Framework 支持在数据库之间进行同步。它提供了一个直观且灵活的 API，使您可以生成面向脱机和协作方案的应用程序。通过该 API，您可以根据应用程序的体系结构和要求，使用所提供的所有或部分组件。Sync Framework 支持客户端-服务器、客户端到客户端和混合拓扑。

Sync Framework 使用“同步提供程序(Synchronization Providers)”与同步的每个数据库进行通信。Sync Framework 数据库提供程序（与 ADO.NET 数据提供程序类似）保护其他 Sync Framework 组件不受各数据库的特定实现方式的影响。Sync Framework 包括五个数据库提供程序，这些提供程序支持两种方案：脱机和协作方案。下图显示一个脱机方案：在客户端-服务器拓扑中，多个客户端连接到一个中央服务器，以便在连接可用时同步数据。

这种偶尔连接的应用程序的一个常见扩展是支持协作应用方案的能力。在协作方案中，两个数据库可以通过对等方式进行同步，而无需通过中央集线器。下图显示一个混合拓扑，其中，一个中央服务器与多个客户端同步，并且这些客户端能够彼此同步。此类拓扑可以支持允许用户共享项目备注的应用程序。项目团队成员常常要求他们可处理的数据的本地副本。当他们进行变更时，他们可以与服务器同步以上载变更，或与其他团队成员同步以交换变更。

数据库同步提供程序

Sync Framework包含的3个主要的数据库同步提供程序同时适用于脱机方案和协作方案，支持客户端-服务器，客户端-客户端和混合拓扑。我们可以各种方式组合使用这些提供程序来对我们选择的拓扑方案进行同步。因为Sync Framework元数据的使用，他们甚至可以和其他的Sync Framework提供程序进行同步。这3个同步提供程序如下：

SqlSyncProvider

对SQL Server、SQL Server Express、和SQL Azure databases进行同步。
提供丰富和可配置的准备工具来为数据库建立必要的同步结构，比如元数据表和存储过程。
包含了灵活的过滤选项用以对需要同步的表按行或列进行过滤，基于参数的过滤机制支持最大限度的重用数据库元素。
提供了相应组件来帮助我们管理同步元数据，包括清除元数据和恢复元素据（当我们从一个备份中恢复数据库时）。

SqlCeSyncProvider

对SQL Server Compact databases进行同步
提供简化的准备工具来为数据库建立必要的同步结构，比如元数据表和存储过程。
可以基于之前准备的SQL Server Compact database 快照高效的创建新的SQL Server Compact databases。
提供了相应组件来帮助我们管理同步元数据。

DbSyncProvider

通常用于同步ADO.NET兼容的非 SQL Server 数据库。
提供了功能完备的API以允许任何ADO.NET兼容的数据库来进行同步工作。

Offline-Only Providers

另外两个数据库同步提供程序只支持脱机方案。这些提供程序已经被上述同时支持脱机方案和协作方案的提供程序取代。所以对于新开发的应用程序，请使用上面介绍的提供程序。脱机方案提供程序包括：DbServerSyncProvider、SqlCeClientSyncProvider 。

这两个提供程序具备如下特征：

适合于客户端-服务器拓扑。
总是成对使用。例如，您不能通过使用 ServerSyncProvider 的两个实例同步两个服务器数据库（改为使用 SqlSyncProvider 或 DbSyncProvider）。
可能没有协作提供程序复杂，但无法与其他 Sync Framework 提供程序一起参与拓扑。

数据库同步的体系结构和类

数据库同步体系结构

在脱机和协作方案中，Sync Framework可以用在两层和N层架构中。在任何一种架构中，下面的活动发生在一个同步会话中：一个synchronization orchestrator与两个同步提供程序进行通讯来对数据库进行获取和应用变更。同步提供程序使用包含了相关SQL Commands的同步适配器(synchronization adapter)来为每个表进行同步。一些提供程序公开这些适配器以允许我们对这些SQL命令进行定制，另外一些提供程序则自动生成适配器来降低同步工作的复杂度。

下图显示了一个两层架构：一个同步会话中的所有组件都位于本地计算机，包含一个直接连接远程数据库的连接。在同步会话中，本地计算机是指发起同步的计算机。如果我们希望对多个计算机进行同步，每个计算机都必须包含图中所示的所有组件。

下图显示了一个N层架构：这种架构需要额外的组件，包括远程计算机中的组件和service，本地计算机上的proxy(代理)将会处理到远程数据库的连接。开发人员必须自己实现proxy和service。

参与同步的数据库可以是SQL Server 2005 SP2或之后的任意版本，包括SQL Server Compact 3.5 SP2及以后版本、SQL Azure、或提供了ADO.NET提供程序的其他数据库。Sync Framework为SQL Server和SQL Server Compact databases自动配置了变更跟踪和元数据存储。

Sync Framework类

SyncOrchestrator（同步代理）

同步代理通过以下方式驱动同步过程：

基于Direction属性来决定应用改变的顺序和方向。
调用服务器同步提供程序以对服务器数据库进行检索和应用变更。
调用客户端同步提供程序以对客户端数据库进行检索和应用变更。

此外，同步代理还维护同步操作的会话级别信息，并向客户端上的应用程序提供成功消息、错误和统计信息。

SyncProvider (SqlSyncProvider, SqlCeSyncProvider, 和DbSyncProvider)

同步提供程序与相应的数据库进行通信，并将同步代理和数据库的特定实现屏蔽开来。对于SQL Server Compact databases ，使用SqlCeSyncProvider；而对于其他版本的SQL Server，包括SQL Azure，使用SqlSyncProvider；对于非SQL数据库使用DbSyncProvider。这3种Providers都继承自RelationalSyncProvider。同步提供程序的主要活动如下所示：

检索自上次同步以来在（本地）数据库中发生的变更。
对（远程）数据库应用增量变更。
检测发生冲突的变更。

SyncAdapter (DbSyncAdapter和SqlCeSyncAdapter)

同步适配器模仿 ADO.NET 中的数据适配器，并为进行同步的每个表定义同步适配器。同步适配器为同步提供程序提供了与数据库交互所需的特定SQL命令。

对于SqlSyncProvider和SqlCeSyncProvider使用的同步适配器，Sync Framework会自动生成相关SQL命令，这样可以降低同步的复杂度。对于DbSyncAdapter，我们需要自己来创建适配器和指定相关SQL命令，例如 InsertCommand，此命令可从客户端数据库向服务器数据库应用插入。由于同步适配器使用 ADO.NET DbCommand 对象，因此可以使用 ADO.NET 支持的任意命令结构。这包括内联 Transact-SQL、存储过程、视图、函数等。这些命令只需要定义了要传输和应用的结构和数据的单个结果。

API中的其他类

上图展示了 API 中主要的类。但是，还有许多类没有在图中展示出来。若要获取有关所有可用类的信息，可以参见 Microsoft.Synchronization、Microsoft.Synchronization.Data、Microsoft.Synchronization.Data.SqlServerCe 和 Microsoft.Synchronization.Data.Server这是个dll中详细的API定义。以下部分介绍了您应该熟悉的其他重要的类。

DbSyncScope（同步作用域）

同步作用域是对进行同步的对象的一种逻辑分组。对于数据库同步，一个同步组通常是一组数据表，并且数据表可以被过滤。同时一个数据表可以被包含在一个或多个同步组中。

Database Provisioning Objects（数据库准备对象）

对于SQL Server和SQL Server Compact databases，Sync Framework提供了一组类用来描述同步组和每个同步组中包含哪些数据表。在这些表和同步组被定义后，我们就可以使用Sync Framework对象来对每个节点应用准备脚本（provisioning scripts）。这些脚本创建了一个变更跟踪和变更应用的基础架构，包含了metadata tables, triggers, 和stored procedures。下表列出了用来准备数据库和提供程序的相关类：

SQL Server、SQL Azure	SQL Server Compact	Description
DbSyncScopeDescription	DbSyncScopeDescription	表示同步作用域，同步作用域是作为一个单元同步的表（可筛选）的逻辑分组。
SqlSyncScopeProvisioning	SqlCeSyncScopeProvisioning	表示用于特定作用域的 SQL Server、SQL Azure 或 SQL Server Compact 数据库的设置
SqlSyncProviderScopeConfiguration	SqlCeSyncProviderScopeConfiguration	表示针对特定作用域的 SqlSyncProvider 或 SqlCeSyncProvider 使用的配置信息。
DbSyncTableDescription	DbSyncTableDescription	表示在同步作用域中包括的表的架构。
DbSyncColumnDescription	DbSyncColumnDescription	表示属于在同步作用域中包括的表的列的架构。
SqlSyncDescriptionBuilder	SqlCeSyncDescriptionBuilder	表示同步中涉及的 SQL Server、SQL Azure 或 SQL Server Compact 数据库的作用域和表信息。
SqlSyncTableProvisioning	SqlSyncTableProvisioning	表示由DbSyncTableDescription 对象表示的SQL Server, SQL Azure, 或SQL Server Compact database设置。
SqlSyncProviderAdapterConfiguration	SqlSyncProviderAdapterConfiguration	表示某个数据库表的同步适配器配置信息

SyncOperationStatistics

会话统计信息是同步代理为每个同步会话提供的一组统计信息。统计信息包括与同步时间、所处理的变更数量以及所发生的任何冲突或异常有关的信息。

DbSyncSession

DbSyncSession对象提供了对同步会话变量的访问。会话变量是一些为开发人员提供的变量，用作在服务器上执行的选择、插入、更新和删除命令的参数。

Sync Framework DLLs

Sync Framework中的数据库同步类包含在如下这些DLLs中：

Microsoft.Synchronization.dll，包含了SyncOrchestrator。

Microsoft.Synchronization.SqlServer.dll，包含了SqlSyncProvider。

Microsoft.Synchronization.SqlServerCe.dll，包含了SqlCeSyncProvider。

Microsoft.Synchronization.Data.dll，包含了RelationalSyncProvider, DbSyncProvider 和DbSyncAdapter。

本篇讲述了数据库同步的背景和优势以及具体的数据库同步提供程序，也讲述了其体系结构和重要的同步类，下一篇我们将通过一个完整的实例来展示如何使用这些提供程序和相关类来完成我们的同步任务。

本文链接

Microsoft Sync Framework基础篇 3：Microsoft Sync Framework元数据和同步流程

2012-03-08T07:00:00Z

Microsoft Sync Framework元数据和同步流程

元数据(Metadata)

Microsoft Sync Framework为脱机和协作的应用程序、数据存储和设备提供了一个完整的同步平台，而不用考虑如下限制：

同步的数据类型
数据存储的类型
传输协议
网络拓扑比如点对点或客户端-服务器拓扑

相反，Sync Framework通过一个通用的元数据模型来允许Sync Framework完成下面的工作：

实现同步过程的互操作性
减少在两个参与同步的data stores之间的数据传输量
使同步独立于任何网络拓扑、数据类型、数据存储和传输协议

在本篇博客中，我们将详细的了解和学习通用的元数据模型以及它的组件，当然，我们也会讨论Sync Framework如何使用元数据来同步不同的数据存储和副本。

什么是元数据

从字面意义上看，元数据是“关于数据的数据”。而Microsoft Sync Framework中使用的元数据包含两种类型：

副本元数据（Replica metadata）
项目元数据（Item metadata）

在Sync Framework中，副本通常是指真正的数据存储。比如，如果我们在同步两个数据库，那么每个数据库都是一个副本，副本可以包含项目。比如，对于数据库，一个项目可以是表中的一条记录。

要同步两个副本， Sync Framework要求同步提供程序使用通用的元数据模型，这也是Sync Framework的核心所在。Sync Framework提供程序使用元数据来检测副本的更新，但是提供程序本身并不要求理解同步元数据（这是Sync Framework运行时的职责所在，它会帮助提供程序来解析同步元数据）。

同步提供程序通过运行时来查询元数据，以发现某个副本自上一次同步以来所作的数据更新。同步元数据还帮助完成对冲突的检测和处理。冲突是指在同步过程中，同一项目在两个副本中被同时修改。同步提供程序使用元数据来判断一个项目是否处于冲突状态并使用元数据来解决冲突。同步元数据还会被Sync Framework运行时使用，以解决通常的同步问题比如网络失败、冲突数据和应用程序错误。

元数据存储（Metadata Store）

你可能会对元数据存放在何处感到好奇，实际上，元数据可以存放在任何地方：一个文件、一个单独的数据库或参与同步的副本上。我们唯一需要保证的就是该元数据存储是可以通过编程来进行访问的。Sync Framework通过调用同步提供程序的不同方法来获取和更新元数据。在实现自己的元数据存储时，我们需要在相应方法被执行时返回和修改我们的元数据。

但多数情况下，我们会把对元数据进行操作的任务托管给Sync Framework运行时，这是因为Microsoft Sync Framework 提供一个以 SQL Server Compact Edition 为基础的完整元数据存储实现，如下图所示。该存储并非必要，但使用它意味着您不必担心如何存储同步元数据。

使用内置的元数据存储还是自定义的元数据存储，取决于创建同步程序的开发人员。但使用内置的元数据存储意味着您不必担心如何存储同步元数据。

同步元数据组件

用于数据存储的元数据可以分为三个主要组件：

版本（Version）
知识（Knowledge）
Tombstones

版本（Version）

同步版本和副本中的项目相关联：该信息记录了项目在何时何处被创建和发生的变化，以及与该项目关联的项目ID。比如在数据库同步中，同步的数据库可以成为副本A和副本B。一个项目可能是数据库中的一个表，或表中的以条记录，甚至是表中某行的一列。

当项目发生更改时，存储的有关该更改的信息将包括创建版本和更新版本。这些版本包含两个组件：

滴答计数：它是一个在整个源副本范围内使用以唯一标识一个更改的逻辑时钟
副本ID：它用于唯一标识发生更改的数据存储。

当首次创建项目时，创建版本与更新版本相同。对该项目的后续更新修改的只是更新版本。

举个例子，假如参与同步的副本A中Customer表的数据如下：

假设我们使用表中ID字段作为项目ID，那么表中记录的版本信息可以用下表来表示：

记录项目版本的过程也叫更改跟踪（change tracking）。要实现更改跟踪，同步提供程序需要为副本中任何时候的修改项目更新其同步版本。更改跟踪（版本）的实现主要有两种方式：

内联跟踪：

在这种方法中，版本的修改在副本中的项目被修改时发生。这种方法通常用在我们可以将修改版本信息的方法嵌入到副本本身时，以数据库为例，我们可以使用触发器在更新行之后立即更新更改跟踪表。

异步跟踪：

在这种方法中，将运行外部进程来扫描更改。发现的任何更新将添加到版本信息当中。该进程可能是定期执行进程的一部分，或者它可能在同步之前执行。该进程通常用于当没有内部机制能够在项目更新时自动更新版本信息的情况中（例如，无法在更新流程中增加版本更新逻辑）。检查更改的常用方式是存储项目的状态，并将存储的状态与项目当前状态进行比较。例如，可检查从上次同步起，最后写入时间或文件大小是否发生变化。

知识（Knowledge）

知识是副本能够感知的数据更改的精简表示。版本和项目相关联，而知识则是和sync scope（同步作用域）相关联。知识包含了在一个副本上直接或间接所作修改的信息。同步提供程序通常不会直接使用知识，取而代之的是，Sync Framework运行时会调用提供者的方法来操作副本的知识。知识的目的在于使同步更加有效，因为它有助于限制在副本之间发送的信息量。当版本信息更新时，用于数据存储的知识也随之更新。

提供程序使用副本知识的目的有：

枚举更改：确定另一个副本没有感知的更改。
检测冲突：确定哪项操作是在不了解彼此知识的情况下做出的。

一个副本的知识由副本ID和副本中最大的滴答计数组合而成，以上面的数据库同步为例，包含Customer表的副本A的知识为A2。

Tombstones

每个副本还必须为每个删除的项目维护tombstone 信息。如果不跟踪删除信息，提供程序将无法告知某个项目（如文件）已被删除。在这种情况下，提供程序无法将更改版本信息发送至其他提供程序。Tombstone 必须包含以下信息：

全局 ID：用于在所有副本中唯一确定 tombstone 项目的副本 ID 和滴答计数。
删除版本：与 tombstone 项目关联的更新版本
创建版本：最初创建项目时关联的副本 ID 和滴答计数

因为 tombstone 日志中的信息将随时间增加，所以有必要创建一个进程定期清理该存储。清理 tombstone 数据能够节省空间并且有助于改善同步性能。Microsoft Sync Framework 支持对tombstone 信息的管理。

同步流程

了解了同步元数据，我们就可以来学习同步流程了。发起同步的副本称为源而源所连接的副本称为目标。本文接下来的部分将介绍下图所示的同步流程。对于双向同步，将执行此进程两次，第二次迭代时会交换源和目标。

1. 发起同步会话

在这一阶段将建立同步会话，从而创建了从源到提供程序的链接。

2. 目标准备并发送知识

如前所述，每个副本都会存储其自身的知识。存储在目标端的知识将传递到源。

3. 目标知识用于确定要发送的更改

在源端，会将刚刚收到的知识与本地项目版本进行比较，以确定目标端尚不了解的项目。值得注意的是，发送的版本并不是实际的项目，而是每个项目上次发生更改的位置摘要。

4. 更改版本和源知识发往目标端

当源准备好所需的更改版本列表之后，这些版本将传输到目标端

5. 检索更改项目的本地版本并与源版本和知识进行比较

目标端使用这些版本准备源需要发送的项目列表。目标还使用该信息检测是否存在限制冲突。限制冲突是指违反了项目限制，如文件夹关系或文件系统中同名数据的位置。

6. 检测并解决或推迟冲突

基本上，如果在两次同步期间对两个副本上的相同项目进行更改就会发生冲突。在 Microsoft Sync Framework 运行时中，当其中一个副本的更改版本不包含另一个副本更改的知识时便会检测到冲突。将在下面的“冲突示例”部分中介绍了说明该检测过程如何工作的更加详细的示例。

副本可以自由实施各种策略，解决同步拓扑间发生冲突的项目。下面列举了一些常用的冲突解决策略：

源获胜：当检测到冲突时，总是采用源副本所做的更改。
目标获胜：总是采用目标副本所做的更改。
合并：将源副本和目标副本所做的更改合并在一起。库存统计可能是一个您希望将两个副本的值合并（求和），而不是选取其中一个作为正确值的例子。
记录冲突：记录或推迟冲突。

7. 目标向源请求项目数据

在这一阶段，目标已经确定需要在源中检索的项目，并将请求发送到源。

8. 源准备并发送项目数据

源接收到项目数据请求，并准备要传输到目标的实际数据。如果要跟踪的项目是数据库中的一行，则将发送该行。如果项目是文件夹中的文件，则将传送该文件。

9. 项目应用到目标中

目标接收并应用项目。如果在此过程中出现任何错误（如网络断开），则该项目将被标记为异常，并在下次同步期间进行更正。从源接收的知识将添加到目标知识。

同步示例

通过使用前面介绍的同步流程，我们将实际操作一次文件同步示例，该示例将说明 Microsoft Sync Framework 如何通过元数据来枚举更改并最终应用项目数据。在本例中有两个副本：副本 A 和副本 B。副本 A 启动与副本 B 的同步（即副本 A 是源而副本 B 是目标）。假定我们希望同步两个副本间的文件。要跟踪的项目是文件夹中的一个文件，表示为 In （例如，I1, I2, I3…）。创建新文件时 (I1) 与该文件相关联的元数据应更新如下：

如果文件再次更新，版本表应如下所示：

在上述示例中，更新滴答计数设置为 5，这是由于用于滴答计数的逻辑时钟在整个源内发挥作用，即：滴答计数 2-4 已用于副本中其他项目的更改。

例如，在下面的图例中，跟踪的副本中有两个附加的项目 I2 和 I3 。您可以看到，随着创建更多的项目，版本信息将变得越来越多。Microsoft Sync Framework 不要求存储以前的更新版本。它只需要了解最新的更新版本。

如果采用该副本的当前项目状态，我们可以把副本 A 的知识表示为：

副本 A 知识 = A5

如前所述，知识是副本能够感知的数据更改的简约表述。在本例中，A 是分配给该副本的唯一 ID，而 5 是当前滴答计数，它使副本能够了解当前的最大变化个数。如果该副本已经与任意其他副本进行同步，则我们还将在该列表中看到这一知识。

在副本 B 上可能也有很多文件。该副本如下所示：

副本 B

副本 B 的当前知识为：

副本 B 知识 = B4

此时我们选择开始在两个副本之间进行同步。副本 A 将成为源（启动同步的副本），副本 B 将成为目标。

同步过程中，目标向源发送其知识。如前所述，两个副本的知识如下：

副本 A 知识 = A5

副本 B 知识 = B4

源（副本 A）收到该知识并使用它来确定将哪个版本发送到目标。由于副本 B 不了解在副本 A 中的任何项目，所以它将发送所有内容。在本例中，副本 A 将包含以下版本。

副本 A 的更改批次

目标接收这些版本并对其进行枚举以确定需要从源请求哪些项目。它还使用该信息确定是否存在任何冲突（例如，在两个副本上更新了相同的文件）。

完成后，目标请求源发送它没有感知的项目。在本例中，副本 A 将发送与 I1、 I2 和 I3。

目标收到这些文件并将其添加到自己的文件夹中。副本 B 的项目现在将包含从副本 A 接收到的项目。

副本 B – 已更新项目表

本次同步结束后，该过程将再执行一遍，这次源将成为目标而目标成为源。这使得副本 A 能够接收到在副本 B 上创建或更改的任何文件（I104 和 I105）。

同步完成后，两个副本上都应包含以下更新知识。

副本 A 知识 = A5， B4

副本 B 知识 = A5， B4

冲突示例

继续前面的示例，两个副本现在已经“同步”，并且每个项目标版本如下：

类似地，两个副本的知识如下：

副本 A 知识 = A5， B4

副本 B 知识 = A5， B4

此时，两个副本都决定更新相同的文件（项目 I2）。

在副本 A 上，该项目标版本表更新为：

在副本 B 上，该项目标版本表更新为：

两个副本的知识也更新为：

副本 A 知识 = A6， B4

副本 B 知识 = A5， B5

此时，副本 A 启动与副本 B 的同步。跳过源向目标发送项目版本和知识这一步，为项目 I2 执行下列步骤。

1. 副本 B 看到项目 I2 新更改，其为：

2. 副本 B 查看从副本 A 收到的知识（A6、B4）并确定副本 A 不了解由副本 B 对相同项目所做的更改：

3. 将检测到冲突并传给应用程序或提供程序进行处理。

如前所述，应用程序能够选择如何处理冲突或延后处理。如果冲突延后处理，则在其解决之前它将在每次同步时重复出现。一旦冲突得到解决，则下一次同步时，原始副本将接收更新后的值。

在系列博客的第一部分基础篇中，通过3篇文章我们了解了同步的背景知识、同步的优点以及Microsoft Sync Framework对同步的实现；讲述了Sync Framework的核心组件和系统架构、各种同步参与方类型；详细的讨论了Sync Framework元数据的作用、同步流程，并实例展示了运行时是如何使用元数据来完成同步的。至此，我们对于Sync Framework的理论基础应该有了一个比较好的理解和掌握，接下去，我们将会详细的讨论使用具体的同步提供程序(Synchronization Providers)来同步各种数据，如数据库、文件、Web Feeds...

本文链接

Microsoft Sync Framework基础篇 2：Microsoft Sync Framework架构与运行时

2012-03-08T01:59:00Z

Microsoft Sync Framework架构与运行时

本篇会先为大家介绍同步的各种参与方，参与方的类型决定了我们是否能够存储元数据，以及是否能够直接启动同步过程。然后会和大家详细讨论Microsoft Sync Framework的核心组件和系统架构，以让大家对Sync Framework有一个全局性的认识和了解。

Sync Framework参与方（Participants）

在讨论Sync Framework核心组件之前，我们需要首先了解Sync Framework 支持的不同类型的同步参加方。参与方是提供程序及其关联副本的组合，代表了同步的一端。要同步的副本（即信息仓库）可以是取自 Web 服务、笔记本电脑、乃至 U 盘中的任何对象。

Microsoft Sync Framework 支持三种类型的参与方：完整、部分和简单。参与方的类型由其存储和处理同步元数据的能力决定。至少，我们可以假定如有请求，副本具备通过程序返回信息的能力。最后需要确定的是副本是否能够：

在现有设备上或当前数据存储中存储和操作信息，并
允许应用程序（我们称之为同步提供程序）直接在设备上执行

区分参与方的类型对于同步生态系统来说十分重要，因为它使我们了解到该参与方是否能够存储提供程序所需的状态信息，以及我们是否能够直接在设备上运行提供程序。最终，参与方模型将成为通用模型。因此，可以将完整参与方配置为部分或简单参与方。

完整参与方

完整参与方是指允许开发人员直接在设备上创建应用程序和新数据存储的设备。笔记本电脑和智能电话就属于完整参与方，因为可以直接从此类设备执行新的应用程序，并且如有必要，您还可以创建新的数据存储以保存信息。

部分参与方

部分参与方是指能够在设备上存储数据的设备。但无法直接从这些设备上启动可执行程序。部分参与方的重要特性在于它能够存储同步所需的元数据，并因此得以与任何完整参与方进行同步。部分参与方的一个例子是 U 盘。这些设备类似于硬盘，能够创建、更新或删除信息。但通常它们不提供使应用程序能够直接在设备上运行的接口。

简单参与方

简单参与方是指仅具备当接到请求时提供信息这一种能力的设备。此类设备不能存储或操作新数据，而且不支持创建新的应用程序。简单参与方依靠完整参与方存储其元数据（因此只能与特定的完整参与方进行同步）。

由外部组织（如 Amazon 或 EBay）提供的 RSS 源和 Web 服务都属于简单参与方。这些组织可能会赋予您执行 Web 服务并取回结果的能力，但不会赋予您在其 Web 服务器上创建您自己的数据存储或执行您自己应用程序的能力。

组合同步参与方

Microsoft Sync Framework 的最终目标是，无论数据源采用哪种参与类型，都允许对它们进行集成。因此，简单和部分参与方可以与完整参与方同步信息。但至少需要一个能够存储信息和启动同步过程的完整参与方。

Sync Framework核心组件

Sync Framework 包括一个运行时、用于特定数据存储区的一组“同步提供程序（synchronization providers）”以及用于编写提供程序的一个 API。提供程序是在数据源和同步系统中的其他组件之间进行通信的软件组件。如果Sync Framework已经为我们要同步的数据存储区提供了提供程序，强烈建议您使用该提供程序。提供程序具有可扩展性，以便您定制它们来适合您的应用程序。如果您要同步我们未提供提供程序的数据存储区或您需要其他实现，则请使用自定义提供程序。

下图显示了 Sync Framework 中所有组件之间的关系。

该图中的组件如下所示：

数据库同步提供程序（在以前的版本中称为 Sync Services for ADO.NET）。这些提供程序包含在 Microsoft.Synchronization.dll、Microsoft.Synchronization.Data.dll、Microsoft.Synchronization.Data.Server.dll、Microsoft.Synchronization.Data.SqlServer.dll 和 Microsoft.Synchronization.Data.SqlServerCe.dll 中。它们可用于在以下类型的方案中同步数据库：
- 协作方案。例如，在一个允许用户共享项目备注的应用程序中，项目团队成员通常需要一份可以处理的数据的本地副本。当他们进行变更时，可以与其他团队成员同步以交换变更，还可以与中央服务器同步变更。
- 脱机方案。例如，一个销售人员需要在客户的办公室访问产品数据，还必须能上载订单。该销售人员可以在每天早上与中央服务器同步以确保具有最新的产品和价格信息，然后在晚上执行同步以上载当天的订单。
文件同步提供程序（在以前的版本中称为 Sync Services for File Systems）。此提供程序包含在 FileSyncProvider21.dll 和 Microsoft.Synchronization.Files.dll 中。它可用于同步 NTFS、FAT 或 SMB 文件系统中的文件和文件夹。要同步的目录可为本地或远程目录，且不必同属一个文件系统。应用程序可以使用静态筛选器通过显式列出文件或使用通配符（如 *.txt）来排除或包括这些文件；或者应用程序可以设置筛选器来排除整个子文件夹。应用程序还可以注册以接收文件同步进度的通知。
Web Feed同步组件（在以前的版本中称为 Sync Services for FeedSync）。这些组件包含在 FeedSync21.dll 和 Microsoft.Synchronization.dll 中。可以通过两种方式使用这些组件：
- Web Feed同步提供程序服务可用于编写将 FeedSync XML 文件表示为其副本的提供程序。
- Web Feed生成方和使用方组件可用于将其他类型的副本（如文件系统）的数据与 RSS 或 Atom Feeds同步。
自定义提供程序。这些组件包含在 Synchronization21.dll 和 Microsoft.Synchronization.dll 以及 SimpleProviders21.dll 和 Microsoft.Synchronization.SimpleProviders.dll 中。它们可用于为任何类型的数据存储区创建同步提供程序。例如，如果应用程序包括用于客户联系人跟踪的自定义存储系统，您可以使用简单提供程序或完全自定义提供程序将该数据集成到您的应用程序。
元数据存储服务。此组件包含在 MetaStore21.dll 和Microsoft.Synchronization.MetadataStorage.dll 中。自定义提供程序可以使用该服务作为存储和处理同步元数据的一种便捷方式，特别对于无法存储元数据的副本很适用。元数据存储服务使用占用较小内存和磁盘空间的可靠轻型数据库，可以随提供程序重新分发。该 API 将元数据存储区与用于访问元数据存储区的接口和方法明确区分开，这样既可实现备用存储区，且对提供程序稍作变更即可使用备用存储区。
核心 API 和运行时。这些组件包含在 Synchronization21.dll 和 Microsoft.Synchronization.dll 中。核心API和运行时由除脱机数据库提供程序之外的其他组件使用。

Sync Framework系统架构

Sync Framework 使用基于提供程序的体系结构。提供程序使其他同步组件不再涉及每个数据存储区的复杂情况和特定实现。这个体系结构配合使用专门的同步元数据，使得 Sync Framework 可以同步编写了提供程序的任何类型的数据存储区。Sync Framework 提供常见数据存储区（如数据库和 NTFS 文件系统）的提供程序，并允许您为其他类型的存储区编写提供程序。提供程序是 Sync Framework 的主要集成点。

下图显示了 Sync Framework 的高级体系结构。同步总是发生在图中所示的两个副本（或“节点”）之间，但是同步社区（或“拓扑”）可以为任何形状，如中心辐射型、对等等。除了一些例外情况外，每对参与者可以根据应用程序的要求在 2 层或 n 层体系结构上同步。每个 Sync Framework 组件的文档提供有关相应体系结构和安全注意事项的详细信息。

图中的元素分为三种类型：

由开发人员编写的元素。
- 应用程序根据应用程序的要求调用同步方法、响应事件和处理其他任务。
- 数据存储区可以是文件系统、关系数据库、平面文件联系人存储区或需要同步的任何其他数据存储区。
- 数据传输协议确定两个提供程序之间传输数据变更的方式。
由 Sync Framework 提供的元素。
- 根据使用的是本机代码还是托管代码，应用程序与同步会话或同步控制器通信，后者与每个同步提供程序通信。
- 同步运行时驱动同步过程并将状态、冲突和错误信息告知客户端应用程序。
由开发人员编写或由 Sync Framework 提供的元素，取决于具体实现方案。
- 提供程序对于正在同步的数据类型而言是特定的。在某些情况下，应用程序需要必须由开发人员编写的自定义提供程序。Sync Framework 提供了很多简化这一过程的 API，还提供了一些组件帮助完成同步最困难的部分（如冲突检测）。
- 元数据存储区包含元数据，Sync Framework 使用这些元数据确定每个提供程序应选择哪些变更并将它们应用到所服务的数据存储区。存储和使用元数据的方式取决于所使用的提供程序。例如，用于数据库的提供程序一般将元数据存储在数据存储区所在数据库的跟踪表中。对于自定义提供程序，您可以创建元数据存储区或使用随 Sync Framework 提供的服务。

在了解了Sync Framework的核心组件和系统架构之后，我会在下一篇中详细的讨论Sync Framework的另一个关键特征：Sync Metadata，即同步元数据。

本文链接

Microsoft Sync Framework基础篇 1：Microsoft Sync Framework简介

2012-03-06T08:29:00Z

前言

最近，Team接手Microsoft Sync Framework（MSF）相关的开发工作，所以得此良机近距离的研究和学习Microsoft Sync Framework这个优秀的同步工具。当然，第一步自然是学习它的使用方式，下面就是本人学习Microsoft Sync Framework的一系列学习笔记，本着分享学习、共同进步的目的，将系列笔记发于博客园。希望与使用Microsoft Sync Framework的园友共同探讨和学习。初涉同步领域，错误或不当之处，还希望大家不吝指正。

下面先给出系列随笔的大致目录，在写作过程中会根据需要进行微调。

第一部分Microsoft Sync Framework基础

Microsoft Sync Framework简介

Microsoft Sync Framework架构与运行时

Microsoft Sync Framework元数据和同步流程

第二部分同步数据库

同步数据库简介

示例：同步 SQL Server 和 SQL Server Compact

针对同步进行设置

第三部分同步文件

同步文件简介

示例

第四部分同步Web Feeds

同步Web Feeds简介

第五部分使用自定义提供程序

自定义提供程序基础

实现简单的自定义提供程序

实现标准的自定义提供程序

第六部分 Microsoft Sync Framework 4.0 CTP

CTP简介

Sync Protocol规范

示例：创建和使用Sync Service

SyncSvcUtil简介

SyncSvcUtilHelper简介

Microsoft Sync Framework简介

引入Microsoft Sync Framework

同步的优点

在深入学习MSF之前，我们有必要先对同步这个概念来做一个了解，以及为什么同步是必须的。简单来说，同步是保持两个端点/数据存储区中数据一致性的过程。当两个数据存储区中内容完全一致时，我们可以说它们是相互同步的。

比如，如果你想手工同步两个数据库，我们通常会这么做：

找出源数据库中的变更
把变更发往目标数据库
在目标数据库中应用变更
交换源数据库和目标数据库，重复上述步骤

那么，对一个程序，数据存储区或services来讲，我们为何需要为其创建同步机制呢？下面列出了同步最常用的好处：

离线操作：同步最大的优点就是使我们能够让程序支持离线操作。如果我们为程序创建了同步机制，那么程序用户就可以和本地数据进行交互。直到我们需要从服务器端下载新数据时或者重新获得网络连接时，才使用联网操作。

创建更快速和丰富的用户界面：通过为程序建立同步机制，我们可以创建更加丰富的用户界面，而不用担心程序的性能问题。因为所有的数据通常都从本地获取，所以程序会为我们提供更加迅速的反馈。

降低网络开销：支持同步的程序通常支持上传/下载的增量更新，所以降低了通过网络传输的数据量。

上面只是列出了同步给我们带来的部分好处，现在，我们应该能够了解同步的必要性了。下面我们将讨论如何实现同步。

实现同步的挑战

虽然同步在理论上十分简单，但是，实践起来却十分困难。理解这些问题会让我们更好的了解Microsoft Sync Framework的重要性。具体来说，同步过程中的问题与挑战如下：

错误与失败处理：设想我们正在同步两个数据库，一个程序错误发生了，比如数据库连接超时或者是往目标数据库应用更改时违反了某个约束，被同步的记录该如何处理呢？

网络失效：还是上面同步数据库的示例，假如一个数据库在从另一个数据库获取更新时，网络突然失效了，我们该如何应对？

冲突检测：冲突是指当同一个数据项目同时被同步两端所修改。我们又该如何应对？

显然，我们可以自己书写代码来解决上述的所有问题。但是如果能有一个同步框架能替我们解决所有这些问题，而我们可以专注于实现自己的业务逻辑时，岂不美哉。好了，是时候介绍Microsoft Sync Framework了，Microsoft为我们提供了这个同步框架，不仅内置了解决上述问题的功能，而且可以在任何网络、任何协议中同步两个数据存储区。

为何选择Microsoft Sync Framework

Microsoft Sync Framework给我们提供的最大好处在于：它的同步功能支持了数据的离线和在线操作。MSF的主要目的在于允许我们的数据同步集成任何数据源，而不论是何种类型的数据。

让我们先来看看Microsoft对于Microsoft Sync Framework的官方定义：Sync Framework 是一个功能完善的同步平台，实现了应用程序、服务和设备的协作和脱机访问。Sync Framework 提供了一些可支持在脱机状态下漫游、共享数据和获取数据的技术和工具。通过使用 Sync Framework，开发人员可以构建同步生态系统，通过在任意网络上使用任意协议，将任意应用程序与任意存储区中的数据集成在一起。

下面是Microsoft Sync Framework的一些主要特征：

独立于底层数据存储、数据类型和协议的强大同步平台
可扩展的提供程序模型
用于同步数据子集的筛选器
内置自动和自定义冲突解决方案
对文件系统、数据库和RSS、Atom feeds的同步支持
支持对等协作方式和客户端-服务器拓扑
为托管代码和非托管代码都提供了API

Microsoft Sync Framework安装

Microsoft Sync Framework 2.1

目前，Microsoft Sync Framework的最新发布版本是2.1（当然下面即将提到的Sync Framework 4.0 CTP除外），我们可以通过SDK安装包安装开发组件。从 Microsoft Download Center（Microsoft 下载中心）下载此安装包，按照该网站上提供的安装说明操作。

在 x86 平台上，x86 安装包将会将主要组件安装到 Program Files\Microsoft SDKs\Microsoft Sync Framework\2.1 中，并且将托管 DLL 添加到全局程序集缓存 (GAC)。在 64 位平台上，x86 和 x64 安装包安装到 Program Files (x86)\Microsoft SDKs\Microsoft Sync Framework\2.1 中。

Sync Framework 2.1 包括以下方面的新功能和增强功能：

数据库提供程序

SQL Azure 同步
成批应用变更
基于参数的筛选
删除作用域和模板
升级元数据格式
SQL Server Compact 3.5 SP2 兼容性

Microsoft Sync Framework 4.0 CTP

Microsoft Sync Framework 4.0 社区技术预览版(CTP)建立在Sync Framework 2.1之上。实际上，Sync Framework 2.1是安装MSF 4.0 CTP的前提，尽管Sync Framework 4.0的最终发布版本会是一个完整的安装包，不再需要Sync Framework 2.1。

请按以下步骤安装Microsoft Sync Framework 4.0 CTP版本：

1．安装Microsoft Sync Framework 2.1 SDK，见前一小节，或直接从这里下载：http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=23217

2．点击以下链接 Sync Framework在线调查完成Microsoft关于Sync Framework的在线调查：

3．一旦你提交了该在线调查，你将会在Microsoft Connect站点看到Sync Framework 4.0 CTP的下载链接:

Microsoft Sync Framework 4.0 CTP对Sync Framework 2.1进行了扩展，以允许我们针对任何平台来创建脱机应用。在Sync Framework之前的版本中，我们必须使用安装了Sync Framework运行时的Windows系统来作为客户端。而CTP允许Microsoft的其他平台比如Silverlight, Windows Phone 7, 和Windows Mobile, 以及其他的非微软平台如iPhone, Android, 和Blackberry，而不需要为这些平台的客户端安装任何Sync Framework组件，这是因为所有的同步逻辑都从客户端移到了服务端。那么Microsoft Sync Framework 4.0 CTP的这种跨平台能力是如何得到的呢，答案在于它定义了一个新的基于HTTP的同步协议：Sync Protocol。

本系列博客以Sync Framework 2.1为主要目标，当然，对于Microsoft Sync Framework 4.0 CTP我也会在专门的篇章里给予详细介绍。

一个简单的示例

下面这个例子将使用Sync Framework内置的文件同步提供程序来实现两个目录之间的同步。

新建一个Console Application(控制台应用程序)，名为FileSyncSample。
添加对Microsoft.Synchronization、Microsoft.Synchronization.Files程序集的引用。
修改Main函数为如下格式：

using System;
using Microsoft.Synchronization.Files;
using Microsoft.Synchronization;

namespace FileSyncSample
{
class Program
{
static void Main(string[] args)
{
// Create Source Sync Provider
FileSyncProvider sourceProvider = new FileSyncProvider(@"C:\TestSync1");
// Create Target Sync Provider
FileSyncProvider destProvider = new FileSyncProvider(@"C:\TestSync2");

// Create Sync Orchestrator(同步会话)
SyncOrchestrator syncAgent = new SyncOrchestrator();
syncAgent.LocalProvider = sourceProvider;
syncAgent.RemoteProvider = destProvider;

// 开始同步
syncAgent.Synchronize();

Console.WriteLine("同步完成");
}
}
}

上面这个简单的程序就完成了两个目录之间的同步工作，请建立相应的目录和文件来验证它的同步功能吧，相信你会和我一样惊讶于Sync Framework让我们的同步工作变得如此简单，那么让我们一起走进Microsoft Sync Framework的世界吧。

本文链接

LINQ之路系列博客导航

2011-12-16T07:34:00Z

LINQ之路系列博客导航

LINQ是.NET Framework 3.5的新特性，其全称是 Language Integrated Query，即语言集成查询，是指将查询功能和语言结合起来。从而为我们提供一种统一的方式，让我们能在C#或VB.NET语言中直接查询和操作各种数据。

本系列文章力图对LINQ进行一个完整和详细的介绍，希望能对广大园友有些许帮助。也期待能和大家一起讨论和学习，共同进步！

第一部分：从这里开始学习LINQ

本部分包含三篇博客，讨论了LINQ的作用以及C#3.0为LINQ提供的语言特性：隐式类型局部变量、自动属性、匿名类型、扩展方法、Lambda表达式、对象初始化器。

LINQ之路 1：LINQ介绍

LINQ之路 2：C# 3.0的语言功能（上）

LINQ之路 3：C# 3.0的语言功能（下）

第二部分：LINQ to Objects

这一部分包含了四篇博客，详细的讲述了LINQ to Objects的方方面面，掌握好这部分内容对于LINQ的学习非常重要，这部分知识也会为LINQ to SQL/Entity Framework和LINQ to XML的学习奠定一个良好的基础。

LINQ之路 4：LINQ方法语法

LINQ之路 5：LINQ查询表达式

LINQ之路 6：延迟执行(Deferred Execution)

LINQ之路 7：子查询、创建策略和数据转换

第三部分：LINQ to SQL/Entity Framework

LINQ提供了两个平行的架构：针对本地对象集合的本地查询（local queries），以及针对远程数据源的解释查询（Interpreted queries）。本部分三篇博客先从原理上介绍解释查询，然后对.NET Framework提供的两个解释查询具体实现进行了讨论和学习：LINQ to SQL、Entity Framework(EF)。

LINQ之路 8：解释查询（Interpreted Queries）

LINQ之路 9：LINQ to SQL 和 Entity Framework（上）

LINQ之路10：LINQ to SQL 和 Entity Framework（下）

第四部分：LINQ Operators

本部分六篇文章中对于LINQ查询运算符（LINQ Operators）进行了完整的介绍，用好它们会让我们的工作更有效率。大家可以按顺序依次对各个LINQ Operators进行学习，也可以把他们作为一个reference，作为参考查询只用。

LINQ之路11：LINQ Operators之过滤(Filtering)

LINQ之路12：LINQ Operators之数据转换(Projecting)

LINQ之路13：LINQ Operators之连接(Joining)

LINQ之路14：LINQ Operators之排序和分组(Ordering and Grouping)

LINQ之路15：LINQ Operators之元素运算符、集合方法、量词方法

LINQ之路16：LINQ Operators之集合运算符、Zip操作符、转换方法、生成器方法

第五部分：LINQ to XML

.NET Framework提供了数种操作XML数据的API。从Framework 3.5开始，最重要的用来处理XML文档的技术当属LINQ to XML。LINQ to XML由一个轻量级的XML文档对象模型和一组补充查询运算符组成，并且，该文档对象模型是LINQ友好的。本部分五篇文章对LINQ to XML进行了详细的介绍。

LINQ之路17：LINQ to XML之X-DOM介绍

LINQ之路18：LINQ to XML之导航和查询

LINQ之路19：LINQ to XML之X-DOM更新、和Value属性交互

LINQ之路20：LINQ to XML之Documents、Declarations和Namespaces

LINQ之路21：LINQ to XML之生成X-DOM（Projecting）

附录：后记

附录包含一篇文章，是我对于本系列博客的一些感想。

LINQ之路系列博客后记

本文链接

LINQ之路系列博客后记

2011-12-14T02:59:00Z

缘起

今年3月，我换了工作单位。后来多次收到公司的新人培训邮件，不过对此我并不感冒，说实话并不喜欢这种活动。印象中，新人培训无非是唠叨些公司的规章制度、侃述一下公司的光辉历史还有灿烂的未来发展等等。规则制度着实无聊，昨天已经过去，公司的未来看似又很遥远，只有今天是实实在在的。但是，新人培训既不会让我的今天舒服（需要占用一天宝贵的周末时间），也不会double我现在的salary！所以就一推再推，赶在试用期结束之前勉强赴约了。嗯，无奈于人事拿转正相威胁，呵呵。

一天培训下来，虽说也有一部分无聊的“照本宣章”，但是其中一位讲师的课程内容还是给我留下了深刻的印象。课程内容从IT服务行业概述到企业的文化氛围；从个人职业素养的形成到团队的协作。她的讲学风格非常生动有趣，能够充分调动听者的积极性和注意力，这也在很大程度上改变了我对新人培训此类活动的看法。课程中讲师关于“学习之塔”的故事则直接激起了我开通个人博客的热情。

学习之塔

学习之塔为我们呈现了不同学习方式之间的效益关系，如下图所示：

在塔底，是第一种学习方式：阅读。包括为了获得某种知识而进行的书本阅读、互联网查询浏览等。这是最熟悉常见的学习方式，但同时其学习效果却是最低的。

第二种学习方式：听讲，接受培训。

第三种学习方式：向先进者学习。

第四种学习方式：培训辅导他人学习。

最后一种位于塔顶的学习方式：书写日记和博客。这是最有效的学习方式，用心书写的日记和博客能真正强化我们对于生活的感悟，对于学习知识/经验的总结。

可以看出，整个学习之塔，由下至上实际上是一个由被动接受向主动参与转化的过程。参与程度越高，学习效果也越好。但在平时的学习过程中，或许对于学习效率越低的方式，使用得却最为普遍。所以，如何改进我们的学习方式，养成更好的学习习惯，对于最终知识的掌握至关重要。

后来经过搜索，在网上发现了著名的“学习金字塔理论”，我在新人培训课程中学到的上述“学习之塔”与其比较相似，有兴趣的朋友可以自己在google或baidu里面找到相关文章。

关于LINQ之路

早些时候，公司leader让组里每位同学准备一个知识讲座，以便空时给大家讲授学习。一来可以锻炼各位的讲述能力，要知道，咱们干技术这行的，口语能力不敢恭维的确也大有人在，我自己就是其中之一；二来可以提高大家的专业知识，形成学习的良好氛围。嗯，学习、学习、再学习，这既是咱程序员的宿命，也是咱程序员的乐趣，呵呵。

我选择的讲座topic就是LINQ。原因之一是LINQ作为C# 3.5/4.0里的一项重要技术发布已有些时日了，自己并没有系统的对它进行了解和学习；再者工作中的项目也大都使用了LINQ相关技术，学习好LINQ，对工作也大有脾益。

LINQ之路是我的第一个系列博客，其写作的过程远没有想象中那么有趣和快速，每一篇的完成都花去了我不少的时间和精力。因为对于每一个知识点的讲解，只有建立在充分理解的基础上才可能做好。虽然博客内容大多来自于翻译和总结，但首先我对原文内容进行了认真的学习和理解，对博客中的相关示例进行了实测和注解；其次对相关表述进行了修改整理，使其尽量符合中文的表达习惯。有时候，为了一个词、一句话能得到准确的表达，都得查阅大量的资料：书本、MSDN、还有网页。

上面的学习之塔中，我们已经看到博客是最有效的学习方式之一。当然，必须是用心书写的博客，是自己真正的理解与领悟，而不是简单的复制粘贴再发布。这也是我为何要为LINQ之路系列博客花费这么多精力的原因。我期望能为广大园友提供高质量的文章，就像我期望能读到别人发布的优秀文章一样。所以，通过LINQ之路系列博客，我也是在实践着自己的期望。本着对自己、对大家负责的态度，我尽全力为阅者奉上了LINQ之路。当然，能力有限，疏漏之处，期望得到大家的指正与理解。始终相信：赠人玫瑰，手留余香。我想LINQ之路系列博客的完成，其实最大的受益者还是我自己。在此，我也强烈建议大家能开通自己的博客，把自己的学习经验进行总结，写下来，share给大家，让大家一起参与讨论，这样你会学得更好，理解得更加深刻！这也是本篇后记的目的所在。

邂逅博客园

那是差不多两年前吧，工作中的一个项目用到WCF，于是到处查阅资料。直到发现Artech的WCF之旅、WCF后续之旅，如获至宝。也由此结识了博客园，发现了有这么个网站，专门为了开发者而生。这里有着负责任的编辑、无私的博主、优秀的文章和热情的园友。所有这些让博客园成为了学习、分享和成长的理想场所。从此博客园也成了我经常光顾逗留的地方，理所当然，它也成了我的LINQ之路系列博客的载体。

感谢

看一篇博客容易，而要写一篇博客就没那么容易了。回头看，最容易想到的就是那么多个安静的夜晚，写博客到深夜零点。尽管这是我的第一个系列博客，尽管我的专业和写作水平非常有限，但我确实是用心用力的把它完成了。能有这么多时间来写博客，关键得益于老婆的支持，原因在于写博客的时候，我那10个多月咿呀学语的宝贝女儿就全靠老婆一人照看了。呵呵，对于我来说，每一篇成功的博客（如果这算成功的话）后面都有一个好女人的支持！老婆辛苦了，谢谢你。当然，享受快乐的同时，还有对女儿深深的歉意，一个好父亲是不该冷落自己的女儿的，何况她那么小。好在，现在终于完成了，我可以好好的陪伴女儿，教他叫“爸爸”、“妈妈”，陪她玩、陪她疯了！哈哈，人生如诗。。。

让自己坚持完成本系列博客的，还有广大园友的热情支持和鼓励，谢谢你们。看到自己的文章被你们支持和肯定是一件很开心的事情，没有这些，写出来的博客也不会有任何意义。借次机会，向你们表示真诚的感谢，感谢你们的每一次阅读，每一次评论！

系列博客导航：

LINQ之路系列博客导航

LINQ之路 1：LINQ介绍

LINQ之路 2：C# 3.0的语言功能（上）

LINQ之路 3：C# 3.0的语言功能（下）

LINQ之路 4：LINQ方法语法

LINQ之路 5：LINQ查询表达式

LINQ之路 6：延迟执行(Deferred Execution)

LINQ之路 7：子查询、创建策略和数据转换

LINQ之路 8：解释查询（Interpreted Queries）

LINQ之路 9：LINQ to SQL 和 Entity Framework（上）

LINQ之路10：LINQ to SQL 和 Entity Framework（下）

LINQ之路11：LINQ Operators之过滤(Filtering)

LINQ之路12：LINQ Operators之数据转换(Projecting)

LINQ之路13：LINQ Operators之连接(Joining)

LINQ之路14：LINQ Operators之排序和分组(Ordering and Grouping)

LINQ之路15：LINQ Operators之元素运算符、集合方法、量词方法

LINQ之路16：LINQ Operators之集合运算符、Zip操作符、转换方法、生成器方法

LINQ之路17：LINQ to XML之X-DOM介绍

LINQ之路18：LINQ to XML之导航和查询

LINQ之路19：LINQ to XML之X-DOM更新、和Value属性交互

LINQ之路20：LINQ to XML之Documents、Declarations和Namespaces

LINQ之路21：LINQ to XML之生成X-DOM（Projecting）

LINQ之路系列博客后记

本文链接

LINQ之路21：LINQ to XML之生成X-DOM（Projecting）

2011-12-13T03:06:00Z

到目前为止，我们已经讨论了如何使用LINQ从一个X-DOM中获取数据。其实，我们同样可以使用LINQ查询来生成一个X-DOM。数据源可以是支持LINQ查询的任何数据，比如：

LINQ to SQL或 Entity Framework查询
本地集合
另外一个X-DOM

不管是何种数据源，使用LINQ来产生X-DOM的策略都是一样的：首先写出产生目标X-DOM的函数式构造表达式，然后针对该表达式创建LINQ查询。

比如，假设我们想从数据库中获取customers并产生如下XML：

我们首先为X-DOM写出函数式构造表达式（这里用简单的字符串值）：

var customers =
new XElement("customers",
new XElement("customer", new XAttribute("id", 1),
new XElement("name", "Sue"),
new XElement("buys", 3)
)
);

然后我们我们把它放入数据转换之中，创建出针对该表达式的LINQ查询：

var customers =
new XElement("customers",
from c in dataContext.Customers
select
new XElement("customer", new XAttribute("id", c.ID),
new XElement("name", c.Name),
new XElement("buys", c.Purchases.Count)
)
);

这里是其结果XML：

<customers>
<customer id="1">
<name>Tom</name>
<buys>3</buys>
</customer>
<customer id="2">
<name>Harry</name>
<buys>2</buys>
</customer>
...
</customers>

通过把上面查询的创建分成两步，我们可以更清楚地理解它的工作方式：

第一步：

// 创建一个普通的LINQ to SQL查询，产生一个XElement sequence
IEnumerable<XElement> sqlQuery =
from c in dataContext.Customers
select
new XElement("customer", new XAttribute("id", c.ID),
new XElement("name", c.Name),
new XElement("buys", c.Purchases.Count)
);

第二步：

// 创建根元素customers
var customers = new XElement("customers", sqlQuery);

唯一不同寻常的事情是内容参数sqlQuery，它不是一个简单的XElement，而是IQueryable<XElement>（实现了IEnumerable<XElement>）。还记得X-DOM处理XML内容的过程吗？记住，它会自动遍历实现了IEnumerable的集合。所以，每个XElement都被作为一个子节点被添加到customers元素下。

排除空元素

假如在上面的例子中，我们还想把customer最新的大额purchase包含进来，那么我们可以创建如下查询：

var customers =
new XElement("customers",
from c in dataContext.Customers
let lastBigBuy = (from p in c.Purchases // 子查询获取最新的大额订单
where p.Price > 1000
orderby p.Date descending
select p).FirstOrDefault()
select
new XElement("customer", new XAttribute("id", c.ID),
new XElement("name", c.Name),
new XElement("buys", c.Purchases.Count),
new XElement("lastBigBuy",
new XElement("description",
lastBigBuy == null ? null : lastBigBuy.Description),
new XElement("price",
lastBigBuy == null ? 0m : lastBigBuy.Price)
)
)
);

当customer没有大额订单时，上面的查询会产生空的lastBigBuy元素。其实在这种情况下，更好的解决方案是完全忽略lastBigBuy节点。我们可以通过把lastBigBuy元素的构造函数包装在条件运算符中来实现这一目的：

select
new XElement ("customer", new XAttribute ("id", c.ID),
new XElement ("name", c.Name),
new XElement ("buys", c.Purchases.Count),
lastBigBuy == null ? null :
new XElement ("lastBigBuy",
new XElement ("description", lastBigBuy.Description),
new XElement ("price", lastBigBuy.Price)
)
)

对于没有lastBigBuy的customers，查询会产生null而不是空的XElement。这正是我们想要的，因为null会被X-DOM简单的忽略掉。

Stream类型元素

如果我们仅是为了保存(或调用ToString)的目的来产生X-DOM，那么我们可以通过XStreamingElement来改善内存的使用效率。一个XStreamingElement相当于XElement的简化版本，并且它对子节点应用延迟加载语义。

使用它时，简单的把外层XElements替换成XStreamingElements即可：

var customers =
new XStreamingElement("customers",
from c in dataContext.Customers
select
new XStreamingElement("customer", new XAttribute("id", c.ID),
new XElement("name", c.Name),
new XElement("buys", c.Purchases.Count)
)
);
customers.Save("data.xml");

直到我们调用Save、ToString或WriteTo方法时，传入XStreamingElement构造函数的查询才会真正被执行。这样就避免了立即把整个X-DOM装载到内存之中。当然另一方面，如果我们多次调用Save，查询也会被重复执行。还有，我们不能遍历XStreamingElement的子节点，它没有提供诸如Elements或Attributes之类的成员。

XStreamingElement不是从XObject（或是其它类）继承而来，它仅有的成员除了Save、ToString和 WriteTo，就是Add方法了，Add方法用于向它添加子节点等内容。

转换X-DOM

我们可以对现有的X-DOM进行转换。比如，C#编译器和Visual Studio为了描述一个项目，会创建相应的XML文件，该文件会类似以下格式：

<Project DefaultTargets="Build" xmlns="http://schemas.microsoft.com/dev...>"
<PropertyGroup>
<Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform>
<ProductVersion>9.0.11209</ProductVersion>
...
</PropertyGroup>
<ItemGroup>
<Compile Include="ObjectGraph.cs" />
<Compile Include="Program.cs" />
<Compile Include="Properties\AssemblyInfo.cs" />
<Compile Include="Tests\Aggregation.cs" />
<Compile Include="Tests\Advanced\RecursiveXml.cs" />
</ItemGroup>
<ItemGroup>
...
</ItemGroup>
...
</Project>

假如我们现在相对该XML文件进行简化，创建一个只包含相关文件的Report，如下所示：

<ProjectReport>
<File>ObjectGraph.cs</File>
<File>Program.cs</File>
<File>Properties\AssemblyInfo.cs</File>
<File>Tests\Aggregation.cs</File>
<File>Tests\Advanced\RecursiveXml.cs</File>
</ProjectReport>

下面的查询可以完成该项转换：

XElement project = XElement.Load("myProjectFile.csproj");
XNamespace ns = project.Name.Namespace; // 获取Namespace
var query =
new XElement("ProjectReport",
from compileItem in
project.Elements(ns + "ItemGroup").Elements(ns + "Compile") // 获取所有的Compile元素
let include = compileItem.Attribute("Include") // 获取Include属性
where include != null
select new XElement("File", include.Value) // 转换X-DOM，创建新的File元素
);

查询首先获取所有的ItemGroup元素，然后使用Elements扩展方法获取所有的Compile子元素（结果位于一个平展的sequence之中）。需要注意的是，我们必须指定一个XML命名空间，因为源文件中的所有节点都继承了定义在Project元素上的命名空间，所以单凭一个本地的元素名称如ItemGroup是不够的。之后，我们根据Include属性创建新的元素。

高级转换

但我们对一个本地集合如X-DOM进行查询时，我们可以通过自定义的查询运算符来创建更加复杂的查询，完成更加高级的功能。

假如在前面的例子中，我们想要的是一个按目录分组的层次输出，如下：

<Project>
<File>ObjectGraph.cs</File>
<File>Program.cs</File>
<Folder name="Properties">
<File>AssemblyInfo.cs</File>
</Folder>
<Folder name="Tests">
<File>Aggregation.cs</File>
<Folder name="Advanced">
<File>RecursiveXml.cs</File>
</Folder>
</Folder>
</Project>

产生这样的结果，我们需要递归的处理路径字符串如： Tests\Advanced\RecursiveXml.cs。下面的方法可以完成这项工作：它接收一个路径sequence，产生我们期望的X-DOM层次结果级：

static IEnumerable<XElement> ExpandPaths(IEnumerable<string> paths)
{
var brokenUp = from path in paths
let split = path.Split(new char[] { '\\' }, 2)
orderby split[0]
select new
{
name = split[0],
remainder = split.ElementAtOrDefault(1)
};

IEnumerable<XElement> files = from b in brokenUp
where b.remainder == null
select new XElement("file", b.name);
IEnumerable<XElement> folders = from b in brokenUp
where b.remainder != null
group b.remainder by b.name into grp
select new XElement("folder",
new XAttribute("name", grp.Key),
ExpandPaths(grp)
);

return files.Concat(folders);
}

上面的方法中，第一个查询以第一个反斜线符号把路径分为两部分：name + remainder。比如：Tests\Advanced\RecursiveXml.cs到Tests + Advanced\RecursiveXml.cs。如果remainder为null，则name就是一个文件，files查询会把它装载到files sequence。如果remainder不为null，name就是一个folder，folders查询会处理这种情况。因为其它文件可能也位于相同的目录中，我们必须按目录名来进行分组。对每一个分组，会递归调用该方法来处理子元素。

最终的结果是包含了所有文件和目录的sequence。Concat运算符会保持元素的顺序，所以所有的文件按字母顺序排在前面，然后是按字母顺序排列的所有目录。

有了这个方法，我们可以通过两步来完成我们的查询。首先，获取所有的文件路径：

IEnumerable<string> paths =
from compileItem in
project.Elements(ns + "ItemGroup").Elements(ns + "Compile")
let include = compileItem.Attribute("Include")
where include != null
select include.Value;

然后，在查询中使用ExpandPaths方法来获得最终结果：

var query = new XElement("Project", ExpandPaths(paths));

至此，LINQ之路系列博客已经接近完成了。从开始的LINQ介绍到C#3.0的语言特性；从LINQ方法语法到查询表达式语法；从延迟执行到子查询；从解释查询到LINQ to SQL/Entity Framework；从各个查询运算符到LINQ to XML。共计21篇博客，前后历时将近2个月，好漫长的过程，真心感谢各位园友的大力支持和陪伴！稍后，会为大家奉上系列博客后记和全篇博客导航。

系列博客导航：

LINQ之路系列博客导航

LINQ之路 1：LINQ介绍

LINQ之路 2：C# 3.0的语言功能（上）

LINQ之路 3：C# 3.0的语言功能（下）

LINQ之路 4：LINQ方法语法

LINQ之路 5：LINQ查询表达式

LINQ之路 6：延迟执行(Deferred Execution)

LINQ之路 7：子查询、创建策略和数据转换

LINQ之路 8：解释查询（Interpreted Queries）

LINQ之路 9：LINQ to SQL 和 Entity Framework（上）

LINQ之路10：LINQ to SQL 和 Entity Framework（下）