Méthode MetadataStore.InitializeReplicaMetadata

Article
10/17/2009

En cas de substitution dans une classe dérivée, crée, initialise et enregistre les nouvelles métadonnées pour un réplica.

Espace de noms: Microsoft.Synchronization.MetadataStorage
Assembly: Microsoft.Synchronization.MetadataStorage (dans microsoft.synchronization.metadatastorage.dll)

Syntaxe

'Déclaration
Public MustOverride Function InitializeReplicaMetadata ( _
    idFormats As SyncIdFormatGroup, _
    replicaId As SyncId, _
    customItemFieldSchemas As IEnumerable(Of FieldSchema), _
    customIndexedFieldSchemas As IEnumerable(Of IndexSchema) _
) As ReplicaMetadata
'Utilisation
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

Paramètres

idFormats
Schéma du format de l'ID du fournisseur.

replicaId
ID de réplica pour le réplica représenté par les métadonnées créées et initialisées.

customItemFieldSchemas
Informations de schéma qui décrivent les champs de métadonnées personnalisés associés aux éléments de métadonnées. Peut être une référence nulle (Rien dans Visual Basic) si aucun champ de métadonnées personnalisé n'existe.

customIndexedFieldSchemas
Liste des schémas d'index qui peuvent être utilisés pour rechercher plus efficacement des éléments dans le magasin des métadonnées. Peut être une référence nulle (Rien dans Visual Basic) si aucun schéma d'index n'existe.

Valeur de retour

Objet ReplicaMetadata qui représente les métadonnées de réplica créées récemment.

Exceptions

Type d'exception	Condition
SyncIdFormatMismatchException	Le schéma du format d'ID spécifié par idFormats ne correspond pas au schéma qui est utilisé pour initialiser les métadonnées de réplica.

Notes

Cette méthode doit effectuer toutes les tâches nécessaires sur le magasin des métadonnées pour créer et initialiser les métadonnées de réplica afin que l'objet ReplicaMetadata retourné puisse être utilisé immédiatement pour accéder et modifier les métadonnées.

Un ensemble de champs personnalisés peut être défini pour les métadonnées d'élément en utilisant customItemFieldSchemas. Chaque champ consiste en un nom de chaîne unique et une valeur. Ces champs peuvent être utilisés pour stocker des métadonnées supplémentaires concernant un élément qui ne sont pas prises en charge par le jeu par défaut de métadonnées d'élément. Les champs peuvent faire l'objet d'un accès par le biais de différentes méthodes sur ItemMetadata, comme ItemMetadata.GetByteField ou Microsoft.Synchronization.MetadataStorage.ItemMetadata.SetCustomField.

Un ensemble de schémas d'index peut être défini à l'aide de customIndexedFieldSchemas afin que les ensembles de champs personnalisés puissent être utilisés comme index pour rechercher efficacement des éléments dans le magasin des métadonnées. Un schéma d'index peut être défini comme étant unique afin de garantir que l'index définit un seul élément. Chaque champ contenu dans un schéma d'index doit également exister dans le schéma de champ personnalisé qui est défini pour le réplica. Les champs d'index peuvent être utilisés dans des méthodes comme ReplicaMetadata.FindItemMetadataByIndexedField et ReplicaMetadata.FindItemMetadataByUniqueIndexedFields.

Voir aussi

Référence

Classe MetadataStore
Membres MetadataStore
Espace de noms Microsoft.Synchronization.MetadataStorage

Partager via