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