Compartilhar via


Método MetadataStore.InitializeReplicaMetadata

Quando substituído em uma classe derivada, cria, inicializa e salva os novos metadados para uma réplica.

Namespace: Microsoft.Synchronization.MetadataStorage
Assembly: Microsoft.Synchronization.MetadataStorage (em microsoft.synchronization.metadatastorage.dll)

Sintaxe

'Declaração
Public MustOverride Function InitializeReplicaMetadata ( _
    idFormats As SyncIdFormatGroup, _
    replicaId As SyncId, _
    customItemFieldSchemas As IEnumerable(Of FieldSchema), _
    customIndexedFieldSchemas As IEnumerable(Of IndexSchema) _
) As ReplicaMetadata
'Uso
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

Parâmetros

  • idFormats
    O esquema de formato de ID do provedor.
  • replicaId
    A ID da réplica representada pelos metadados que estão sendo criados e inicializados.
  • customItemFieldSchemas
    As informações de esquema que descrevem os campos de metadados personalizados que são associados aos itens de metadados. Poderá ser referência nula (Nothing no Visual Basic) se não houver nenhum campo de metadados personalizado.
  • customIndexedFieldSchemas
    A lista de esquemas de índice que pode ser usada para localizar itens no repositório de metadados de forma mais eficiente. Pode ser um referência nula (Nothing no Visual Basic) se nenhum esquema de índice existir.

Valor de retorno

Um objeto ReplicaMetadata que representa os metadados da réplica recém-criados.

Exceções

Tipo de exceção Condição

SyncIdFormatMismatchException

O esquema de formato de ID especificado por idFormats não corresponde ao esquema usado para inicializar os metadados da réplica.

Comentários

Este método deve executar todas as tarefas necessárias no repositório de metadados para criar e inicializar metadados da réplica de forma que o objeto ReplicaMetadata retornado possa ser usado para acessar e modificar os metadados imediatamente.

Um conjunto de campos personalizados pode ser definido para metadados de item usando customItemFieldSchemas. Cada campo consiste em um nome de cadeia de caracteres exclusivo e um valor. Esses campos podem ser usados para armazenar quaisquer metadados adicionais sobre um item que não é aceito pelo conjunto padrão de metadados do item. Os campos podem ser acessados por meio de vários métodos no ItemMetadata, como ItemMetadata.GetByteField ou Microsoft.Synchronization.MetadataStorage.ItemMetadata.SetCustomField.

Um conjunto de esquemas de índice pode ser definido com o uso de customIndexedFieldSchemas de forma que conjuntos de campos personalizados possam ser usados como índices para a localização eficiente de itens no repositório de metadados. Um esquema de índice pode ser definido como exclusivo para assegurar que o índice define um item único. Cada campo contido em um esquema de índice também deve existir no esquema de campo personalizado definido para a réplica. Os campos de índice podem ser usados em métodos como ReplicaMetadata.FindItemMetadataByIndexedField e ReplicaMetadata.FindItemMetadataByUniqueIndexedFields.

Consulte também

Referência

Classe MetadataStore
Membros MetadataStore
Namespace Microsoft.Synchronization.MetadataStorage