Compartir a través de

MetadataStore.InitializeReplicaMetadata Método

  • Artículo

Cuando se invalida en una clase derivada, crea, inicializa y guarda metadatos nuevos para una réplica.

Espacio de nombres: Microsoft.Synchronization.MetadataStorage
Ensamblado: Microsoft.Synchronization.MetadataStorage (en microsoft.synchronization.metadatastorage.dll)

Sintaxis

'Declaración
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
    Esquema de formato de identificador del proveedor.
  • replicaId
    Identificador de réplica para la réplica representada por los metadatos que se van a crear e inicializar.
  • customItemFieldSchemas
    Información de esquema que describe los campos de metadatos personalizados que están asociados a los metadatos de los elementos. Puede ser un valor NULL si no existe ningún campo de metadatos personalizado.
  • customIndexedFieldSchemas
    Lista de los esquemas de índice que pueden utilizarse para buscar más eficazmente elementos en el almacén de metadatos. Puede ser un valor NULL si no existe ningún esquema de índice.

Valor devuelto

Objeto ReplicaMetadata que representa los metadatos de réplica que acaban de crearse.

Excepciones

Tipo de excepción Condición

SyncIdFormatMismatchException

El esquema de formato de identificador especificado mediante idFormats no coincide con el que se usa para inicializar los metadatos de la réplica.

Notas

Este método debe realizar todas las tareas necesarias en el almacén de metadatos para crear e inicializar metadatos de réplica para que el objeto ReplicaMetadata devuelto se pueda usar inmediatamente para obtener acceso a los metadatos y modificarlos.

Se puede definir un conjunto de campos personalizados para los metadatos del elemento mediante customItemFieldSchemas. Cada campo está compuesto por un nombre de cadena único y un valor. Si existen metadatos adicionales relacionados con un elemento que no son admitidos por el conjunto predeterminado de metadatos del elemento, pueden almacenarse en estos campos. Se puede tener acceso a los campos con varios métodos de ItemMetadata, como ItemMetadata.GetByteField o Microsoft.Synchronization.MetadataStorage.ItemMetadata.SetCustomField.

Se puede definir un conjunto de esquemas de índice con customIndexedFieldSchemas para que los conjuntos de campos personalizados se puedan usar como índices para buscar eficazmente elementos en el almacén de metadatos. Un esquema de índice se puede definir como único para asegurarse de que el índice define un solo elemento. Cada uno de los campos contenidos en un esquema de índice también debe existir en el esquema de campos personalizados definido para la réplica. Los campos de índice se pueden usar en métodos como ReplicaMetadata.FindItemMetadataByIndexedField y ReplicaMetadata.FindItemMetadataByUniqueIndexedFields.

Vea también

Referencia

MetadataStore Clase
MetadataStore Miembros
Microsoft.Synchronization.MetadataStorage Espacio de nombres