ReplicaMetadata.FindItemMetadataByIndexedField 方法

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

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

语法

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

returnValue = instance.FindItemMetadataByIndexedField(fieldName, fieldValue)

public abstract IEnumerable<ItemMetadata> FindItemMetadataByIndexedField (
    string fieldName,
    Object fieldValue
)

public:
virtual IEnumerable<ItemMetadata^>^ FindItemMetadataByIndexedField (
    String^ fieldName, 
    Object^ fieldValue
) abstract

public abstract IEnumerable<ItemMetadata> FindItemMetadataByIndexedField (
    String fieldName, 
    Object fieldValue
)

public abstract function FindItemMetadataByIndexedField (
    fieldName : String, 
    fieldValue : Object
) : IEnumerable<ItemMetadata>

参数

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

• fieldValue
  索引字段的值。

返回值

索引字段具有指定值的项元数据条目的列表。如果不存在这样的项，则返回一个空集合。

异常

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

备注

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

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

请参阅

参考

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