MetadataStore.InitializeReplicaMetadata-Methode

Artikel
11/02/2009

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

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

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

Parameter

idFormats
Das ID-Formatschema für den Anbieter.

replicaId
Die Replikat-ID für das Replikat, das von den erstellten und initialisierten Metadaten dargestellt wird.

customItemFieldSchemas
Die Schemainformationen zur Beschreibung der benutzerdefinierten Metadatenfelder, die den Metadatenelementen zugeordnet sind. Kann den Wert NULL haben, wenn keine benutzerdefinierten Metadatenfelder vorhanden sind.

customIndexedFieldSchemas
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

Ein ReplicaMetadata-Objekt, das die neu erstellten Replikatmetadaten darstellt.

Ausnahmen

Ausnahmetyp	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 Microsoft.Synchronization.MetadataStorage.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

Freigeben über