Метод MetadataStore.InitializeReplicaMetadata

Статья
10/17/2009

После переопределения в производном классе этот метод создает, инициализирует и сохраняет новые метаданные для реплики.

Пространство имен: Microsoft.Synchronization.MetadataStorage
Сборка: Microsoft.Synchronization.MetadataStorage (в microsoft.synchronization.metadatastorage.dll)

Синтаксис

'Декларация
Public MustOverride Function InitializeReplicaMetadata ( _
    idFormats As SyncIdFormatGroup, _
    replicaId As SyncId, _
    customItemFieldSchemas As IEnumerable(Of FieldSchema), _
    customIndexedFieldSchemas As IEnumerable(Of IndexSchema) _
) As ReplicaMetadata
'Применение
Dim instance As MetadataStore
Dim idFormats As SyncIdFormatGroup
Dim replicaId As SyncId
Dim customItemFieldSchemas As IEnumerable(Of FieldSchema)
Dim customIndexedFieldSchemas As IEnumerable(Of IndexSchema)
Dim returnValue As ReplicaMetadata

returnValue = instance.InitializeReplicaMetadata(idFormats, replicaId, customItemFieldSchemas, customIndexedFieldSchemas)

public abstract ReplicaMetadata InitializeReplicaMetadata (
    SyncIdFormatGroup idFormats,
    SyncId replicaId,
    IEnumerable<FieldSchema> customItemFieldSchemas,
    IEnumerable<IndexSchema> customIndexedFieldSchemas
)

public:
virtual ReplicaMetadata^ InitializeReplicaMetadata (
    SyncIdFormatGroup^ idFormats, 
    SyncId^ replicaId, 
    IEnumerable<FieldSchema^>^ customItemFieldSchemas, 
    IEnumerable<IndexSchema^>^ customIndexedFieldSchemas
) abstract

public abstract ReplicaMetadata InitializeReplicaMetadata (
    SyncIdFormatGroup idFormats, 
    SyncId replicaId, 
    IEnumerable<FieldSchema> customItemFieldSchemas, 
    IEnumerable<IndexSchema> customIndexedFieldSchemas
)

public abstract function InitializeReplicaMetadata (
    idFormats : SyncIdFormatGroup, 
    replicaId : SyncId, 
    customItemFieldSchemas : IEnumerable<FieldSchema>, 
    customIndexedFieldSchemas : IEnumerable<IndexSchema>
) : ReplicaMetadata

Параметры

idFormats
Схема форматов идентификаторов для поставщика.

replicaId
Идентификатор реплики, представленной метаданными, которые были созданы и инициализированы.

customItemFieldSchemas
Информация схем, описывающая пользовательские поля метаданных, связанные с элементами метаданных. Может иметь значение пустая ссылка (Nothing в Visual Basic), если пользовательских полей метаданных не существует.

customIndexedFieldSchemas
Список схем индексов, которые можно использовать для более эффективного поиска элементов в хранилище метаданных. Может иметь значение пустая ссылка (Nothing в Visual Basic), если схем индексов не существует.

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

Объект ReplicaMetadata, представляющий только что созданные метаданные реплики.

Исключения

Тип исключения	Условие
SyncIdFormatMismatchException	Схема форматов идентификаторов, заданная параметром idFormats, не соответствует схеме, используемой для инициализации метаданных реплики.

Замечания

Этот метод должен выполнять все необходимые задачи в хранилище метаданных, чтобы создать и инициализировать метаданные реплики, чтобы возвращенный объект ReplicaMetadata можно было немедленно использовать для доступа к метаданным и их изменения.

Параметр customItemFieldSchemas позволяет определить набор пользовательских полей для метаданных элемента. Каждое поле состоит из уникального строкового имени и значения. Эти поля можно использовать для хранения любых дополнительных метаданных об элементе, которые не поддерживаются в стандартном наборе метаданных для элемента. Доступ к полям можно получить с помощью различных методов класса ItemMetadata, например ItemMetadata.GetByteField или Microsoft.Synchronization.MetadataStorage.ItemMetadata.SetCustomField.

Набор схем индексов можно определить с помощью параметра customIndexedFieldSchemas таким образом, чтобы наборы пользовательских полей можно было использовать в качестве индексов для эффективного поиска элементов в хранилище метаданных. Схему индекса можно определить как уникальную, чтобы индекс гарантированно указывал на один элемент. Каждое поле, содержащееся в схеме индекса, должно существовать и в схеме пользовательских полей, определенной для реплики. Поля индекса могут использоваться в таких методах, как ReplicaMetadata.FindItemMetadataByIndexedField и ReplicaMetadata.FindItemMetadataByUniqueIndexedFields.

См. также

Справочник

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

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