InitializeReplicaMetadata-Methode

Erstellt, initialisiert und speichert beim Überschreiben in einer abgeleiteten Klasse neue Metadaten für ein Replikat.

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

Syntax

'Declaration
Public MustOverride Function InitializeReplicaMetadata ( _
    idFormats As SyncIdFormatGroup, _
    replicaId As SyncId, _
    customItemFieldSchemas As IEnumerable(Of FieldSchema), _
    customIndexedFieldSchemas As IEnumerable(Of IndexSchema) _
) As ReplicaMetadata
'Usage
Dim instance As MetadataStore
Dim idFormats As SyncIdFormatGroup
Dim replicaId As SyncId
Dim customItemFieldSchemas As IEnumerable(Of FieldSchema)
Dim customIndexedFieldSchemas As IEnumerable(Of IndexSchema)
Dim returnValue As ReplicaMetadata

returnValue = instance.InitializeReplicaMetadata(idFormats, _
    replicaId, customItemFieldSchemas, _
    customIndexedFieldSchemas)

public abstract ReplicaMetadata InitializeReplicaMetadata(
    SyncIdFormatGroup idFormats,
    SyncId replicaId,
    IEnumerable<FieldSchema> customItemFieldSchemas,
    IEnumerable<IndexSchema> customIndexedFieldSchemas
)

public:
virtual ReplicaMetadata^ InitializeReplicaMetadata(
    SyncIdFormatGroup^ idFormats, 
    SyncId^ replicaId, 
    IEnumerable<FieldSchema^>^ customItemFieldSchemas, 
    IEnumerable<IndexSchema^>^ customIndexedFieldSchemas
) abstract

abstract InitializeReplicaMetadata : 
        idFormats:SyncIdFormatGroup * 
        replicaId:SyncId * 
        customItemFieldSchemas:IEnumerable<FieldSchema> * 
        customIndexedFieldSchemas:IEnumerable<IndexSchema> -> ReplicaMetadata 

public abstract function InitializeReplicaMetadata(
    idFormats : SyncIdFormatGroup, 
    replicaId : SyncId, 
    customItemFieldSchemas : IEnumerable<FieldSchema>, 
    customIndexedFieldSchemas : IEnumerable<IndexSchema>
) : ReplicaMetadata

Parameter

  • customItemFieldSchemas
    Typ: System.Collections.Generic. . :: . .IEnumerable< (Of < ( <'FieldSchema> ) > ) >
    Die Schemainformationen zur Beschreibung der benutzerdefinierten Metadatenfelder, die den Metadatenelementen zugeordnet sind. Kann den Wert NULL haben, wenn keine benutzerdefinierten Metadatenfelder vorhanden sind.
  • customIndexedFieldSchemas
    Typ: System.Collections.Generic. . :: . .IEnumerable< (Of < ( <'IndexSchema> ) > ) >
    Die Liste der Indexschemas, die zur effizienteren Suche der Elemente im Metadatenspeicher verwendet werden können. Kann den Wert NULL haben, wenn keine Indexschemas vorhanden sind.

Rückgabewert

Typ: Microsoft.Synchronization.MetadataStorage. . :: . .ReplicaMetadata
Ein ReplicaMetadata-Objekt, das die neu erstellten Replikatmetadaten darstellt.

Ausnahmen

Ausnahme Bedingung
SyncIdFormatMismatchException

Das von idFormats angegebene ID-Formatschema entspricht nicht dem Schema, mit dem Replikatmetadaten initialisiert werden.

Hinweise

Alle erforderlichen Aufgaben im Metadatenspeicher zum Erstellen und Initialisieren von Replikatmetadaten müssen von dieser Methode ausgeführt werden, damit das zurückgegebene ReplicaMetadata-Objekt sofort für den Zugriff auf und die Bearbeitung von Metadaten verwendet werden kann.

Ein Satz benutzerdefinierter Felder kann mithilfe von customItemFieldSchemas für Elementmetadaten definiert werden. Jedes Feld besteht aus einem eindeutigen Zeichenfolgennamen und einem Wert. Mithilfe dieser Felder können zusätzliche Metadaten zu einem Element gespeichert werden, das andernfalls nicht vom Standardsatz der Elementmetadaten unterstützt wird. Auf die Felder kann mithilfe verschiedener Methoden für ItemMetadata zugegriffen werden, z. B. mit ItemMetadata..::..GetByteField oder ItemMetadata..::..SetCustomField.

Ein Satz von Indexschemas kann mithilfe von customIndexedFieldSchemas so definiert werden, dass Sätze benutzerdefinierter Felder als Indizes zum effizienten Suchen von Elementen im Metadatenspeicher verwendet werden können. Ein Indexschema kann als eindeutig definiert werden, um sicherzustellen, dass der Index ein einzelnes Element definiert. Jedes in einem Indexschema enthaltene Feld muss auch im benutzerdefinierten Feldschema vorhanden sein, das für das Replikat definiert ist. Indexfelder können in Methoden wieReplicaMetadata..::..FindItemMetadataByIndexedField und ReplicaMetadata..::..FindItemMetadataByUniqueIndexedFields verwendet werden.

Siehe auch

Verweis

MetadataStore Klasse

MetadataStore-Member

Microsoft.Synchronization.MetadataStorage-Namespace

  • Last updated on