SqlSyncMetadataStoreSerializer.SerializeReplicaMetadata Method

Serializes, for the specified replica, the contents of a metadata storage service store to a destination file in a canonical format.

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

Syntax

'Declaration
Public Overrides Sub SerializeReplicaMetadata ( _
    idFormats As SyncIdFormatGroup, _
    replicaId As SyncId, _
    serializedFilePath As String, _
    compatibilityLevel As CompatibilityLevel _
)
'Usage
Dim instance As SqlSyncMetadataStoreSerializer
Dim idFormats As SyncIdFormatGroup
Dim replicaId As SyncId
Dim serializedFilePath As String
Dim compatibilityLevel As CompatibilityLevel

instance.SerializeReplicaMetadata(idFormats, replicaId, serializedFilePath, compatibilityLevel)

public override void SerializeReplicaMetadata (
    SyncIdFormatGroup idFormats,
    SyncId replicaId,
    string serializedFilePath,
    CompatibilityLevel compatibilityLevel
)

public:
virtual void SerializeReplicaMetadata (
    SyncIdFormatGroup^ idFormats, 
    SyncId^ replicaId, 
    String^ serializedFilePath, 
    CompatibilityLevel compatibilityLevel
) override

public void SerializeReplicaMetadata (
    SyncIdFormatGroup idFormats, 
    SyncId replicaId, 
    String serializedFilePath, 
    CompatibilityLevel compatibilityLevel
)

public override function SerializeReplicaMetadata (
    idFormats : SyncIdFormatGroup, 
    replicaId : SyncId, 
    serializedFilePath : String, 
    compatibilityLevel : CompatibilityLevel
)

Parameters

• idFormats
  The ID format schema of the provider.

• replicaId
  The ID of the replica for which metadata should be serialized.

• serializedFilePath
  The destination file to which metadata is serialized.

• compatibilityLevel
  A CompatibilityLevel value that specifies for which version of Sync Framework the serialized metadata is valid. For example, if the native knowledge serialization format is Sync Framework 2.0, but the value provided for this parameter is Sync Framework 1.0, knowledge values are serialized in the 1.0 format. If knowledge values use any 2.0 features that cannot be serialized in the 1.0 format, serialization throws an InvalidSerializationVersionException exception.

Exceptions

Exception type	Condition
ArgumentNullException	A required parameter is a null reference (Nothing in Visual Basic).
ArgumentException	serializedFilePath is an empty string; serializationVersion is a value other than SyncFrameworkVersion1 or WindowsSync.
SyncIdFormatMismatchException	The format of replicaId is not of the format specified by idFormats.
SyncInvalidOperationException	The metadata store is not open.
ExplicitTransactionRequiredException	A transaction is not available within which to serialize metadata.

Remarks

Two conditions must be met before this method is called:

• The metadata store must be opened. Open a store by calling OpenStore or CreateStore.

• An active transaction must be available on the SqlMetadataStore object. Start a transaction by calling BeginTransaction.

Calling this method when either of these conditions is not met results in an exception.

See Also

Reference

SqlSyncMetadataStoreSerializer Class
SqlSyncMetadataStoreSerializer Members
Microsoft.Synchronization.MetadataStorage Namespace