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
abstract SaveReplicaMetadata : unit -> unit 
public abstract function SaveReplicaMetadata()

Exceptions

Exception 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

Microsoft.Synchronization.MetadataStorage Namespace