ReplicaMetadata.FindItemMetadataByUniqueIndexedField 方法

在派生类中重写时，返回索引字段具有指定值的唯一项元数据条目。

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

语法

声明
Public MustOverride Function FindItemMetadataByUniqueIndexedField ( _
    fieldName As String, _
    fieldValue As Object _
) As ItemMetadata
用法
Dim instance As ReplicaMetadata
Dim fieldName As String
Dim fieldValue As Object
Dim returnValue As ItemMetadata

returnValue = instance.FindItemMetadataByUniqueIndexedField(fieldName, fieldValue)

public abstract ItemMetadata FindItemMetadataByUniqueIndexedField (
    string fieldName,
    Object fieldValue
)

public:
virtual ItemMetadata^ FindItemMetadataByUniqueIndexedField (
    String^ fieldName, 
    Object^ fieldValue
) abstract

public abstract ItemMetadata FindItemMetadataByUniqueIndexedField (
    String fieldName, 
    Object fieldValue
)

public abstract function FindItemMetadataByUniqueIndexedField (
    fieldName : String, 
    fieldValue : Object
) : ItemMetadata

参数

• fieldName
  唯一索引字段的名称。该字段必须是一个有效的唯一索引字段。

• fieldValue
  唯一索引字段的值。

返回值

索引字段具有指定值的唯一元数据条目。不存在这样的项时，返回一个 null 引用（在 Visual Basic 中为 Nothing）。

异常

异常类型	条件
ObjectDisposedException	对象已释放或未正确初始化。
ArgumentNullException	fieldName 或 fieldValue 为 null 引用（在 Visual Basic 中为 Nothing）。
ArgumentException	fieldName 的长度为 0，或 fieldValue 是字符串类型，且长度为 0。
NotSupportedException	fieldValue 的类型不受支持。
MetadataFieldNotFoundException	fieldName 找不到或无效。
MetadataStoreInvalidOperationException	指定的字段不是一个唯一索引。

备注

通过将 FieldSchema 传递到 InitializeReplicaMetadata 来首次初始化副本元数据时，必须建立自定义字段。

通过将 IndexSchema 传递到 InitializeReplicaMetadata 来首次初始化副本元数据时，必须建立索引字段，并标记为唯一。

请参阅

参考

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