通过

Microsoft.Synchronization.MetadataStorage 命名空间

  • 项目

Metadata Storage Service 支持存储和处理同步元数据。

Metadata Storage Service 将其很多类定义为抽象类，以便存储服务编写器能够实现自定义类组，以在任何类型的数据存储中存储元数据。

Metadata Storage Service 还提供一些类的实现，这些类使用轻型数据库在文件系统的单个数据库文件中存储同步元数据。

所有元数据存储区的主类为 MetadataStore。此抽象基类包含初始化和获取元数据存储区中的副本元数据以及启动和停止数据库事务的方法。重写此基类的类将可能会提供创建和打开元数据存储区（如 SqlMetadataStore）的方法。此类包含创建和打开元数据存储区的方法。

副本元数据是通过使用 InitializeReplicaMetadata 在元数据存储区中初始化的。使用此方法的 FieldSchema 参数，可以创建一组自定义字段。这些字段可用于在元数据存储区存储项的其他元数据。使用 IndexSchema 参数可将字段组定义为索引。这些字段可用于有效地查找元数据存储区中的项。

ReplicaMetadata 类封装某特定副本的所有元数据。使用类似 GetKnowledge 和 ReplicaId 的成员可访问副本元数据：

ReplicaMetadata 还包含 DeleteDetector。提供程序可使用此属性中包含的对象检来测哪些项已从项存储区中删除，并且应在元数据存储区中标记为已删除。

可以通过下面的方法在元数据存储区中找到项元数据：使用 ReplicaMetadata 方法按项 ID 或索引字段（如 FindItemMetadataById 或 FindItemMetadataByIndexedFields）进行搜索。ItemMetadata 类可封装特定项的所有元数据。此类包含标准的同步元数据，如 ChangeVersion、CreationVersion、GlobalId 和 IsDeleted。此类还包含多个方法，这些方法可用于访问初始化副本元数据时定义的任何自定义字段。

类

  类 说明
Public class ChangeUnitMetadata 表示与同步作用域中的项中包含的变更单位相关联的元数据。
Public class DeleteDetector 通过派生类实现时，DeleteDetector 确定从副本中删除的项。这些项应在元数据存储区中标记为已删除。
Public class ExplicitTransactionRequiredException 调用要求已对元数据存储区启动显式事务的方法时引发的异常。
Public class FieldSchema 包含为元数据存储区中的项定义自定义字段的架构信息。
Public class IndexSchema 表示一个单列或多列索引，该索引可用于更有效地查找元数据存储区中的项。
Public class ItemMetadata 重写时，表示与同步作用域中的项相关联的元数据。
Public class ItemMetadataNotFoundException 在元数据存储区中找不到具有指定的 ID 或自定义字段值的项时引发的异常。
Public class KeyUniquenessException 尝试保存其 ID 无效或重复的项时引发的异常。
Public class MetadataFieldNotFoundException 命名的自定义字段不存在时所引发的异常。
Public class MetadataStorageEngineException 对元数据存储引擎执行操作失败时引发的异常。
Public class MetadataStore 重写时，表示元数据存储区，并提供获取副本元数据对象的方法。该副本元数据对象用于访问某特定副本的元数据。这是使用 Metadata Storage Service API 的所有元数据存储区的抽象基类。
Public class MetadataStoreException 所有元数据存储异常的基类。
Public class MetadataStoreInvalidOperationException 方法调用对当前状态的对象无效时引发的异常。
Public class ReplicaMetadata 重写时，提供对元数据存储区中的副本元数据和项元数据的访问。ReplicaMetadata 还对删除检测和用于实现同步提供程序方法的帮助器提供服务。
Public class ReplicaMetadataAlreadyExistsException 在元数据存储区中已经存在副本元数据的情况下，尝试在元数据存储区中创建新的副本元数据时引发的异常。
Public class ReplicaMetadataInUseException 尝试创建一个特定副本 ID 的多个活动 ReplicaMetadata 实例时引发的异常。
Public class ReplicaMetadataNotFoundException 当元数据存储区中不存在具有指定副本 ID 的副本元数据时引发的异常。
Public class SqlMetadataStore 表示通过使用轻型数据库存储元数据来实现的元数据存储区。
Public class VersionNotSupportedException 尝试从元数据存储区获取副本元数据，但元数据存储区的实现不支持该元数据的版本时引发的异常。

委托

  委托 说明
Public delegate ReplicaMetadata.ItemFilterCallback 表示将用于确定项变更是否应包括在变更批中的方法。