ReplicaMetadata.FindItemMetadataById 方法

在派生类中重写时，获取具有指定全局 ID 的项的项元数据。

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

语法

声明
Public MustOverride Function FindItemMetadataById ( _
    globalId As SyncId _
) As ItemMetadata
用法
Dim instance As ReplicaMetadata
Dim globalId As SyncId
Dim returnValue As ItemMetadata

returnValue = instance.FindItemMetadataById(globalId)

public abstract ItemMetadata FindItemMetadataById (
    SyncId globalId
)

public:
virtual ItemMetadata^ FindItemMetadataById (
    SyncId^ globalId
) abstract

public abstract ItemMetadata FindItemMetadataById (
    SyncId globalId
)

public abstract function FindItemMetadataById (
    globalId : SyncId
) : ItemMetadata

参数

• globalId
  项的全局 ID。

返回值

具有指定 ID 的项的项元数据。不存在这样的项时，返回 null 引用（在 Visual Basic 中为 Nothing）。

异常

异常类型	条件
ObjectDisposedException	对象已释放或未正确初始化。
ArgumentNullException	globalId 为 null 引用（在 Visual Basic 中为 Nothing）。
SyncIdFormatMismatchException	globalId 的格式与副本的 ID 格式架构所指定的格式不匹配。
ItemMetadataNotFoundException	找不到指定项的项元数据。

备注

项的元数据表示项存储区中某项的信息，如其当前版本、创建版本以及该项可用的所有自定义字段。

请参阅

参考

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