IdFormats propriété

Article
08/18/2010

En cas de substitution dans une classe dérivée, obtient un objet SyncIdFormatGroup qui représente le format des ID de réplica et d'élément.

Espace de noms : Microsoft.Synchronization.SimpleProviders
Assembly : Microsoft.Synchronization.SimpleProviders (dans Microsoft.Synchronization.SimpleProviders.dll)

Syntaxe

'Déclaration
Public MustOverride ReadOnly Property IdFormats As SyncIdFormatGroup
    Get
'Utilisation
Dim instance As SimpleSyncProvider
Dim value As SyncIdFormatGroup

value = instance.IdFormats

public abstract SyncIdFormatGroup IdFormats { get; }

public:
virtual property SyncIdFormatGroup^ IdFormats {
    SyncIdFormatGroup^ get () abstract;
}

abstract IdFormats : SyncIdFormatGroup

abstract function get IdFormats () : SyncIdFormatGroup

Valeur de la propriété

Type : Microsoft.Synchronization. . :: . .SyncIdFormatGroup
Objet SyncIdFormatGroup utilisé pour définir le format des ID de réplica et d'élément.

Notes

Pour synchroniser un élément, Sync Framework doit être en mesure d'identifier l'élément en question dans le magasin d'éléments et de mapper cette identité à un ID interne dans le magasin des métadonnées. Les fournisseurs qui se synchronisent entre eux doivent utiliser un format commun pour les ID de réplica et d'élément, spécifié par la propriété IdFormats.

Exemples

Le code suivant définit le constructeur de l'exemple de classe MyFullEnumerationSimpleSyncProvider et la propriété IdFormats. Le runtime de Sync Framework utilise cette propriété pour déterminer quel format le magasin des métadonnées utilise pour les ID. Si les ID flexibles ne sont pas utilisés, Sync Framework utilise un format fixe pour identifier les réplicas, les éléments et les unités de modification. Si les ID flexibles sont utilisés, les méthodes ISimpleSyncProviderIdGenerator sont utilisées pour générer des ID. Pour consulter ce code dans le contexte d'une application complète, consultez l'application "Sync101 using Simple Sync Provider" qui est disponible dans le Kit de développement logiciel (SDK) Sync Framework et de Code Gallery.

public MyFullEnumerationSimpleSyncProvider(string name, MySimpleDataStore store)
{
    _name = name;
    _store = store;

    // Create a file to store metadata for all items and a file to store 
    // the replica ID.
    _replicaMetadataFile = Environment.CurrentDirectory + "\\" + _name.ToString() + ".Metadata";
    _replicaIdFile = Environment.CurrentDirectory + "\\" + _name.ToString() + ".Replicaid";

    // Set ReplicaIdFormat to use a GUID as an ID, and ItemIdFormat to use a GUID plus
    // an 8-byte prefix.
    _idFormats = new SyncIdFormatGroup();
    _idFormats.ItemIdFormat.IsVariableLength = false;
    _idFormats.ItemIdFormat.Length = 24;
    _idFormats.ReplicaIdFormat.IsVariableLength = false;
    _idFormats.ReplicaIdFormat.Length = 16;

    this.ItemConstraint += new EventHandler<SimpleSyncItemConstraintEventArgs>(OnItemConstraint);
    this.ItemConflicting += new EventHandler<SimpleSyncItemConflictingEventArgs>(OnItemConflicting);
}

public SyncId ReplicaId
{
    get 
    {
        if (_replicaId == null)
        {
            _replicaId = GetReplicaIdFromFile( _replicaIdFile);
        }

        return _replicaId; 
    }
}

public override SyncIdFormatGroup IdFormats
{
    get { return _idFormats; }
}

Public Sub New(ByVal name As String, ByVal store As MySimpleDataStore)
    _name = name
    _store = store

    ' Create a file to store metadata for all items and a file to store 
    ' the replica ID. 
    _replicaMetadataFile = (Environment.CurrentDirectory & "\") + _name.ToString() & ".Metadata"
    _replicaIdFile = (Environment.CurrentDirectory & "\") + _name.ToString() & ".Replicaid"

    ' Set ReplicaIdFormat to use a GUID as an ID, and ItemIdFormat to use a GUID plus 
    ' an 8-byte prefix. 
    _idFormats = New SyncIdFormatGroup()
    _idFormats.ItemIdFormat.IsVariableLength = False
    _idFormats.ItemIdFormat.Length = 24
    _idFormats.ReplicaIdFormat.IsVariableLength = False
    _idFormats.ReplicaIdFormat.Length = 16

    AddHandler Me.ItemConstraint, AddressOf HandleItemConstraint
    AddHandler Me.ItemConflicting, AddressOf HandleItemConflicting
End Sub
Public ReadOnly Property ReplicaId() As SyncId
    Get
        If _replicaId Is Nothing Then
            _replicaId = GetReplicaIdFromFile(_replicaIdFile)
        End If

        Return _replicaId
    End Get
End Property

Public Overrides ReadOnly Property IdFormats() As SyncIdFormatGroup
    Get
        Return _idFormats
    End Get
End Property

Voir aussi

Référence

SimpleSyncProvider Classe

Membres SimpleSyncProvider

Espace de noms Microsoft.Synchronization.SimpleProviders

Partager via