ReplicaMetadata.SaveItemMetadata-Methode

Artikel
11/02/2009

Speichert, wenn in einer abgeleiteten Klasse überschrieben, die Änderungen der Eigenschaften von Elementmetadaten im Metadatenspeicher.

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

Syntax

'Declaration
Public MustOverride Sub SaveItemMetadata ( _
    itemMetadata As ItemMetadata _
)
'Usage
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
)

Parameter

itemMetadata
Die im Metadatenspeicher zu speichernden Elementmetadaten.

Ausnahmen

Ausnahmetyp	Bedingung
ObjectDisposedException	Das Objekt wurde verworfen oder nicht ordnungsgemäß initialisiert.
ArgumentNullException	itemMetadata ist NULL.
KeyUniquenessException	Das Element ist ein neues Element, und die ID ist im Metadatenspeicher bereits vorhanden oder ungültig.

Hinweise

Diese Methode muss aufgerufen werden, um ItemMetadata-Eigenschaftenänderungen im Metadatenspeicher zu speichern. Wenn ItemMetadata-Eigenschaften geändert werden und das Objekt ohne Aufrufen dieser Methode gelöscht wird, gehen diese Änderungen verloren.

Es wird empfohlen, diese Methode aufzurufen, um Metadatenänderungen zu speichern, nachdem die entsprechenden Änderungen in den Elementspeicher gespeichert wurden. Dadurch ist gewährleistet, dass die Metadaten nicht geändert werden, wenn die Datenaktualisierung fehlschlägt.

Die Implementierung dieser Klasse, die durch SqlMetadataStore verfügbar ist, führt im Rahmen einer Transaktion, die vor Aufruf dieser Methode gestartet wurde, Aktualisierungen durch.

Hinweise für Implementierer: Diese Methode darf nur erfolgreich abgeschlossen werden, wenn alle Eigenschaftenänderungen erfolgreich an den Metadatenspeicher übergeben wurden. Wenn nicht für alle Eigenschaftenänderungen ein Commit ausgeführt werden kann, darf für keine Eigenschaftenänderung ein Commit ausgeführt werden. Wenn der Metadatenspeicher Transaktionen unterstützt, muss diese Methode die Änderungen im Kontext dieser Transaktion in den Metadatenspeicher übernehmen.

Siehe auch

Verweis

ReplicaMetadata-Klasse
ReplicaMetadata-Member
Microsoft.Synchronization.MetadataStorage-Namespace

Freigeben über