Метод ReplicaMetadata.FindItemMetadataByUniqueIndexedField

Статья
10/17/2009

При переопределении в производном классе этот метод возвращает уникальную запись метаданных элемента, имеющую указанное значение индексированного поля.

Пространство имен: 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
Значение уникального индексированного поля.

Возвращаемое значение

Уникальная запись метаданных, имеющая указанное значение индексированного поля. Если элемент не существует, возвращается значение пустая ссылка (Nothing в Visual Basic).

Исключения

Тип исключения	Условие
ObjectDisposedException	Объект удален или неправильно инициализирован.
ArgumentNullException	Параметр fieldName или fieldValue равен пустая ссылка (Nothing в Visual Basic).
ArgumentException	Длина параметра fieldName равна 0, или параметр fieldValue имеет строковый тип и нулевую длину.
NotSupportedException	Параметр fieldValue имеет неподдерживаемый тип.
MetadataFieldNotFoundException	Поле fieldName не найдено или неверно.
MetadataStoreInvalidOperationException	Указанное поле не является уникальным индексом.

Замечания

Настраиваемые поля необходимо определить при первой инициализации метаданных реплики. Для этого нужно передать значение FieldSchema методу InitializeReplicaMetadata.

Поля индекса должны быть определены и помечены как уникальные при первой инициализации метаданных реплики. Для этого нужно передать значение IndexSchema методу InitializeReplicaMetadata.

См. также

Справочник

Класс ReplicaMetadata
Элементы ReplicaMetadata
Пространство имен Microsoft.Synchronization.MetadataStorage

Поделиться через