Méthode ReplicaMetadata.CreateItemMetadata

Article
10/17/2009

En cas de substitution dans une classe dérivée, crée un nouvel objet des métadonnées de l'élément qui peut être utilisé pour ajouter une nouvelle entrée des métadonnées de l'élément dans le magasin des métadonnées.

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

Syntaxe

'Déclaration
Public MustOverride Function CreateItemMetadata ( _
    globalId As SyncId, _
    creationVersion As SyncVersion _
) As ItemMetadata
'Utilisation
Dim instance As ReplicaMetadata
Dim globalId As SyncId
Dim creationVersion As SyncVersion
Dim returnValue As ItemMetadata

returnValue = instance.CreateItemMetadata(globalId, creationVersion)

public abstract ItemMetadata CreateItemMetadata (
    SyncId globalId,
    SyncVersion creationVersion
)

public:
virtual ItemMetadata^ CreateItemMetadata (
    SyncId^ globalId, 
    SyncVersion^ creationVersion
) abstract

public abstract ItemMetadata CreateItemMetadata (
    SyncId globalId, 
    SyncVersion creationVersion
)

public abstract function CreateItemMetadata (
    globalId : SyncId, 
    creationVersion : SyncVersion
) : ItemMetadata

Paramètres

globalId
ID global de l'élément à créer. L'ID global doit être unique.

creationVersion
Version de création à associer à cet élément.

Valeur de retour

Objet des métadonnées de l'élément nouvellement créé.

Exceptions

Type d'exception	Condition
ObjectDisposedException	L'objet a été supprimé ou n'a pas été initialisé correctement.
ArgumentNullException	globalId ou creationVersion est une référence nulle (Rien dans Visual Basic).
OutOfMemoryException	Il n'y a pas assez de mémoire pour créer les métadonnées d'élément.
SyncIdFormatMismatchException	Le format de globalId ne correspond pas au format qui a été spécifié lors de l'initialisation des métadonnées de réplica.

Notes

Ces métadonnées d'élément ne sont pas enregistrées dans le magasin des métadonnées tant que SaveItemMetadata n'a pas été appelée.

Exemple

L'exemple suivant crée des métadonnées pour un élément, définit la version de chaque unité de modification de l'élément et définit les valeurs de champ personnalisé pour les champs d'index de l'élément.

private ItemMetadata CreateContactMetadata(Contact contact, SyncId itemId, SyncVersion creationVersion,
    SyncVersion changeVersion)
{
    // Create the item by using the metadata storage service.
    ItemMetadata itemMeta = _ContactReplicaMetadata.CreateItemMetadata(itemId, creationVersion);

    // Set the version information for each change unit.
    itemMeta.SetChangeUnitVersion(new SyncId((byte)Contact.ChangeUnitFields.NameCU), changeVersion);
    itemMeta.SetChangeUnitVersion(new SyncId((byte)Contact.ChangeUnitFields.PhoneCU), changeVersion);
    itemMeta.SetChangeUnitVersion(new SyncId((byte)Contact.ChangeUnitFields.AddressCU), changeVersion);
    itemMeta.SetChangeUnitVersion(new SyncId((byte)Contact.ChangeUnitFields.BirthdateCU), changeVersion);

    // A unique index is defined for the combination of first name, last name, and phone number in order
    // to map between the item ID and the contact.
    // Set the field values for the index fields.
    itemMeta.SetCustomField(FirstNameField, contact.FirstName);
    itemMeta.SetCustomField(LastNameField, contact.LastName);
    itemMeta.SetCustomField(PhoneNumberField, contact.PhoneNumber);

    return itemMeta;
}

Voir aussi

Référence

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

Partager via