Méthode ReplicaMetadata.SaveItemMetadata

Article
10/17/2009

En cas de substitution dans une classe dérivée, enregistre les modifications apportées à la propriété de métadonnées d'é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 Sub SaveItemMetadata ( _
    itemMetadata As ItemMetadata _
)
'Utilisation
Dim instance As ReplicaMetadata
Dim itemMetadata As ItemMetadata

instance.SaveItemMetadata(itemMetadata)

public abstract void SaveItemMetadata (
    ItemMetadata itemMetadata
)

public:
virtual void SaveItemMetadata (
    ItemMetadata^ itemMetadata
) abstract

public abstract void SaveItemMetadata (
    ItemMetadata itemMetadata
)

public abstract function SaveItemMetadata (
    itemMetadata : ItemMetadata
)

Paramètres

itemMetadata
Métadonnées d'élément à enregistrer dans le magasin des métadonnées.

Exceptions

Type d'exception	Condition
ObjectDisposedException	L'objet a été supprimé ou n'a pas été initialisé correctement.
ArgumentNullException	itemMetadata est une référence nulle (Rien dans Visual Basic).
KeyUniquenessException	L'élément est un nouvel élément et l'ID existe déjà dans le magasin des métadonnées, ou l'ID n'est pas valide.

Notes

Cette méthode doit être appelée pour enregistrer les modifications apportées à la propriété ItemMetadata dans le magasin des métadonnées. Si les propriétés ItemMetadata sont modifiées et l'objet est détruit sans appeler cette méthode, ces modifications seront perdues.

Nous recommandons que cette méthode soit appelée pour enregistrer des modifications de métadonnées après que la modification correspondante a été enregistrée dans le magasin d'éléments. Cela aide à garantir que les métadonnées ne sont pas modifiées si la mise à jour des données échoue.

L'implémentation de cette classe qui est disponible via SqlMetadataStore effectue des mises à jour dans le contexte d'une transaction démarrée avant l'appel à cette méthode.

Remarques à l'attention des implémenteurs : Cette méthode doit réussir uniquement lorsque toutes les modifications de propriété ont été validées avec succès dans le magasin des métadonnées. Les modifications de propriété doivent être validées toutes ou aucune. Si le magasin des métadonnées prend en charge les transactions, cette méthode doit appliquer ses modifications au magasin des métadonnées dans le contexte de cette transaction.

Voir aussi

Référence

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

Partager via