SqlSyncMetadataStoreSerializer Class

Serializes and deserializes metadata for a replica between a canonical metadata file format and version-specific metadata storage service store formats.

Inheritance Hierarchy

System.Object
  Microsoft.Synchronization.MetadataStorage.SyncMetadataStoreSerializer
    Microsoft.Synchronization.MetadataStorage.SqlSyncMetadataStoreSerializer

Namespace:  Microsoft.Synchronization.MetadataStorage
Assembly:  Microsoft.Synchronization.MetadataStorage (in Microsoft.Synchronization.MetadataStorage.dll)

Syntax

'Declaration
Public Class SqlSyncMetadataStoreSerializer _
    Inherits SyncMetadataStoreSerializer
'Usage
Dim instance As SqlSyncMetadataStoreSerializer
public class SqlSyncMetadataStoreSerializer : SyncMetadataStoreSerializer
public ref class SqlSyncMetadataStoreSerializer : public SyncMetadataStoreSerializer
type SqlSyncMetadataStoreSerializer =  
    class
        inherit SyncMetadataStoreSerializer
    end
public class SqlSyncMetadataStoreSerializer extends SyncMetadataStoreSerializer

The SqlSyncMetadataStoreSerializer type exposes the following members.

Methods

  Name Description
Public method DeserializeReplicaMetadata Deserializes the contents of a canonical metadata file to a metadata storage service store. Optionally upgrades the metadata store format when the provider version changes. (Overrides SyncMetadataStoreSerializer.DeserializeReplicaMetadata(String, UInt32, IProviderUpgradeCallback).)
Public method Equals (Inherited from Object.)
Protected method Finalize (Inherited from Object.)
Public method GetHashCode (Inherited from Object.)
Public method GetSerializedReplicaId Returns the replica ID for the replica whose metadata was serialized to the specified destination file. (Overrides SyncMetadataStoreSerializer.GetSerializedReplicaId(String, SyncId%, SyncIdFormatGroup%).)
Public method GetType (Inherited from Object.)
Protected method MemberwiseClone (Inherited from Object.)
Public method SerializeReplicaMetadata Serializes, for the specified replica, the contents of a metadata storage service store to a destination file in a canonical format. (Overrides SyncMetadataStoreSerializer.SerializeReplicaMetadata(SyncIdFormatGroup, SyncId, String, CompatibilityLevel).)
Public method ToString (Inherited from Object.)

Top

Remarks

Serialization of the metadata file to a canonical format by using the SyncMetadataStoreSerializer methods can be used to interoperate among components of differing versions. For more information, see Accessing Metadata from Components with Different Versions.

Serialization of the metadata file to a canonical format by using the SyncMetadataStoreSerializer methods can be used to upgrade the metadata store when the provider version changes. For more information, see Upgrading the Metadata Store Version.

The SyncMetadataStoreSerializer class has the following behaviors regarding concurrent serialization and deserialization operations for a metadata store:

  • Concurrent operations for a single replica's metadata are not supported, regardless of whether operations are executed in different processes or on different threads in the same process.

  • Concurrent serialization and deserialization operations for a metadata store are supported only if each operation affects a different replica's metadata and each operation is performed over a different connection.

Serialization and deserialization operations are not supported while a replica is synchronizing.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

Microsoft.Synchronization.MetadataStorage Namespace

Other Resources

Accessing Metadata from Components with Different Versions

Upgrading the Metadata Store Version