ReplicaMetadata.SaveReplicaMetadata Method

When overridden in a derived class, saves replica metadata property changes to the metadata store.

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

Syntax

'Declaration
Public MustOverride Sub SaveReplicaMetadata
'Usage
Dim instance As ReplicaMetadata

instance.SaveReplicaMetadata
public abstract void SaveReplicaMetadata ()
public:
virtual void SaveReplicaMetadata () abstract
public abstract void SaveReplicaMetadata ()
public abstract function SaveReplicaMetadata ()

Exceptions

Exception type Condition

ObjectDisposedException

The object has been disposed or was not initialized correctly.

Remarks

The provider must determine the correct level of precision at which to call this method, depending on its consistency guarantee. Some examples of when it might be appropriate to call this method include: after applying each change during change application, after each item batch is applied, or one time at the end of the synchronization session.

The implementation of this class that is available through SqlMetadataStore performs updates within the context of a transaction that was started before this method is called.

Note

This method does not save item metadata. To save changes to metadata for individual items, SaveItemMetadata must be called.

Notes to Implementers: This method must only succeed when all the property changes were successfully committed to the metadata store. Either all property changes must be committed or none of them. If the metadata store supports transactions, this method must apply its changes to the metadata store within the context of that transaction.

See Also

Reference

ReplicaMetadata Class
ReplicaMetadata Members
Microsoft.Synchronization.MetadataStorage Namespace