通过

ReplicaMetadata.RemoveItemMetadata 方法

  • 项目

在派生类中重写时，从元数据存储区中删除项元数据。

命名空间: Microsoft.Synchronization.MetadataStorage
程序集: Microsoft.Synchronization.MetadataStorage（在 microsoft.synchronization.metadatastorage.dll 中）

语法

声明
Public MustOverride Sub RemoveItemMetadata ( _
    globalIds As IEnumerable(Of SyncId) _
)
用法
Dim instance As ReplicaMetadata
Dim globalIds As IEnumerable(Of SyncId)

instance.RemoveItemMetadata(globalIds)

public abstract void RemoveItemMetadata (
    IEnumerable<SyncId> globalIds
)

public:
virtual void RemoveItemMetadata (
    IEnumerable<SyncId^>^ globalIds
) abstract

public abstract void RemoveItemMetadata (
    IEnumerable<SyncId> globalIds
)

public abstract function RemoveItemMetadata (
    globalIds : IEnumerable<SyncId>
)

参数

  • globalIds
    要删除的项的全局 ID 的集合。

异常

异常类型 条件

ObjectDisposedException

对象已释放或未正确初始化。

ArgumentNullException

globalIds 为 null 引用（在 Visual Basic 中为 Nothing）。

SyncIdFormatMismatchException

globalIds 中的 ID 的格式与初始化此副本元数据时所指定的格式架构不匹配。

ItemMetadataNotFoundException

在元数据中找不到 globalIds 中列出的项。对于可通过 SqlMetadataStore 获得的此类的实现，在导致异常的项之前枚举出的所有项都会从元数据中删除。

备注

可通过 SqlMetadataStore 获得的此类的实现立即在存储区执行此操作。如果存在未完成的显式事务，则该事务中将会进行上述操作，并且如果该事务没有被提交或回滚，则也将回滚该操作。

备注

用这种方法将项标记为逻辑删除是不正确的。若要将项标记为逻辑删除，请将 ItemMetadata.IsDeleted 设置为 true。当要停止跟踪某项的元数据并要从存储区中完全删除该项时（如在清除逻辑删除期间），提供程序可使用此方法。

请参阅

参考

ReplicaMetadata 类
ReplicaMetadata 成员
Microsoft.Synchronization.MetadataStorage 命名空间