Microsoft.Synchronization.SimpleProviders 命名空间

此命名空间包含用于为 Sync Framework 创建简单提供程序的类型。

Sync Framework 提供各种 API:从域特定的 API(如文件同步提供程序)到适用于同步各种数据存储区的开放式核心 API,应有尽有。简单提供程序 API 处于这两类 API 的中间位置。它们给予开发人员核心 API 的强大功能和良好的灵活性,但是更好掌握,涉及的代码更少,特别适用于不能很好支持或不支持变更跟踪的副本。简单提供程序 API 是可扩展的,但是它主要用于以下两种副本类型:

  • 不支持任何种类的变更跟踪的副本。此类副本使用“完全枚举提供程序”**(FullEnumerationSimpleSyncProvider),每次进行同步时该提供程序枚举来自源副本的所有项。

  • 支持基于定位点的变更跟踪的副本。此类副本使用“基于定位点的提供程序”**(AnchorEnumerationSimpleSyncProvider),该提供程序枚举在设置特定定位点(通常为一个时间点)后源副本中变更的项。

有关简单提供程序的更多信息,请参见如何创建托管的简单提供程序。有关常规自定义提供程序的更多信息,请参见自定义提供程序的基础知识,特别是“在简单提供程序和标准提供程序之间进行选择”一节。

  说明
Public class AnchorEnumerationContext 传递到 AnchorEnumerationSimpleSyncProvider 对象的同步会话上下文。
Public class AnchorEnumerationSimpleSyncProvider 表示通过使用定位点跟踪变更的副本的提供程序。
Public class ChangeDetectionCompletedEventArgs ChangeDetectionCompleted 事件提供数据。
Public class ChangeUnitVersionDefinition 表示 Sync Framework 运行时用于确定某一变更单位的版本是否应更新的字段组。
Public class ConflictVersionInformation 表示有关远程提供程序针对存在冲突的特定项已知的项版本的信息。
Public class CustomFieldDefinition 表示可用于标识元数据存储区中的项或者为项或变更单位存储版本相关信息的字段。
Public class FullEnumerationContext 传递到 FullEnumerationSimpleSyncProvider 对象的同步会话上下文。
Public class FullEnumerationSimpleSyncProvider 表示不支持任何类型的跟踪变更的副本的提供程序。
Public class IdentityRule 定义在副本内标识项的方式。
Public class ItemEnumerationContext 表示传递到某一提供程序的同步会话上下文。
Public class ItemField 表示在将变更应用到目标时用来标识项的方法。
Public class ItemFieldDictionary 表示一个项及其关联字段。
Public class ItemMetadataSchema 表示项的元数据架构,这包括如何标识项及其版本信息,以及如何定义变更单位。
Public class LocalItemChange 表示对 EnumerateChanges 返回的本地副本中的项的变更。
Public class MetadataStoreInitializedEventArgs MetadataStoreInitialized 事件提供数据。
Public class RecoverableErrorReportingContext 表示在某些调用期间传递到提供程序的同步会话上下文,以便提供程序可以报告在该调用的上下文内发生的任何可恢复错误。
Public class SimpleSyncItemConflictingEventArgs ItemConflicting 事件提供数据。
Public class SimpleSyncItemConstraintEventArgs ItemConstraint 事件提供数据。
Public class SimpleSyncProvider 表示用于同步副本的简单提供程序。您通常将扩展 FullEnumerationSimpleSyncProviderAnchorEnumerationSimpleSyncProvider
Public class SimpleSyncServices 表示为使用简单提供程序的副本设计的一组服务。
Public class UnmanagedSimpleSyncProviderWrapper 表示一个包装非托管简单提供程序的托管对象。

接口

  接口 说明
Public interface IFilteredSimpleSyncProvider 表示筛选数据的提供程序,这可能导致两个副本只同步在各副本上可用的数据的子集。
Public interface ISimpleSyncProviderConcurrencyConflictResolver 表示用于处理并发冲突(例如从本地副本中更新一个项的同时在远程副本上删除该项)的自定义冲突解决程序。
Public interface ISimpleSyncProviderConstraintConflictResolver 表示用于处理约束冲突(例如将重复项插入多个副本)的自定义冲突解决程序。
Public interface ISimpleSyncProviderIdGenerator 提供一个方法,以便生成用于在元数据存储区中标识副本和项的自定义格式的 ID。

枚举

  枚举 说明
Public enumeration ConcurrencyConflictKind 表示由于对位于本地副本和远程副本上的相同项发生了变更而因此可能发生的冲突类型。
Public enumeration LocalItemChangeType 表示本地副本中的项可能发生的变更类型。
Public enumeration SimpleSyncProviderDeleteMode 表示用于指示是否将本地项删除传播到其他副本的选项。
Public enumeration SimpleSyncProviderFilterOptions 表示可用于经筛选的同步的选项。