語言

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 命名空間

  • Last updated on