InitializeReplicaMetadata メソッド
派生クラスでオーバーライドされると、レプリカの新しいメタデータを作成して初期化し、保存します。
名前空間: Microsoft.Synchronization.MetadataStorage
アセンブリ: Microsoft.Synchronization.MetadataStorage (Microsoft.Synchronization.MetadataStorage.dll 内)
構文
'宣言
Public MustOverride Function InitializeReplicaMetadata ( _
idFormats As SyncIdFormatGroup, _
replicaId As SyncId, _
customItemFieldSchemas As IEnumerable(Of FieldSchema), _
customIndexedFieldSchemas As IEnumerable(Of IndexSchema) _
) As ReplicaMetadata
'使用
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
パラメーター
- idFormats
型 : Microsoft.Synchronization. . :: . .SyncIdFormatGroup
プロバイダーの ID 形式スキーマです。
- replicaId
型 : Microsoft.Synchronization. . :: . .SyncId
作成および初期化されているメタデータによって表されるレプリカのレプリカ ID です。
- customItemFieldSchemas
型 : System.Collections.Generic. . :: . .IEnumerable< (Of < ( <'FieldSchema> ) > ) >
メタデータ項目に関連付けられているカスタム メタデータ フィールドについて説明したスキーマ情報です。カスタム メタデータ フィールドがない場合は、nullNothingnullptrunitNULL 参照 (Visual Basic では Nothing) が返されることがあります。
- customIndexedFieldSchemas
型 : System.Collections.Generic. . :: . .IEnumerable< (Of < ( <'IndexSchema> ) > ) >
メタデータ ストアにおける項目の検索を効率化するために使用されるインデックス スキーマの一覧です。インデックス スキーマがない場合は、nullNothingnullptrunitNULL 参照 (Visual Basic では Nothing) が返されることがあります。
戻り値
型 : Microsoft.Synchronization.MetadataStorage. . :: . .ReplicaMetadata
新しく作成されたレプリカ メタデータを表す ReplicaMetadata オブジェクトです。
例外
例外 | 条件 |
---|---|
SyncIdFormatMismatchException | idFormats によって指定された ID 形式スキーマが、レプリカ メタデータを初期化するために使用されるスキーマと一致しません。 |
説明
このメソッドはレプリカ メタデータを作成および初期化するために必要なすべてのタスクをメタデータ ストアに対して実行する必要があります。それによって返される ReplicaMetadata オブジェクトをすぐに使用して、メタデータにアクセスしたり、変更したりできるようになります。
customItemFieldSchemas を使用すると、項目メタデータに対して一連のカスタム フィールドを定義できます。各フィールドは、一意の文字列の名前と値で構成されます。これらのフィールドを使用すると、既定の項目メタデータでサポートされていないような、項目に関する追加のメタデータを格納できます。フィールドにアクセスするには、ItemMetadata..::..GetByteField や ItemMetadata..::..SetCustomField などのさまざまなメソッドを ItemMetadata に対して使用します。
customIndexedFieldSchemas を使用してインデックス スキーマを定義すると、一連のカスタム フィールドをインデックスとして使用して、メタデータ ストア内の項目を効率的に検索できるようになります。インデックス スキーマを一意に定義すると、インデックスによって単一の項目が定義されるようになります。インデックス スキーマに含まれている各フィールドは、レプリカ用に定義されたカスタム フィールド スキーマ内にも存在する必要があります。インデックス フィールドは、ReplicaMetadata..::..FindItemMetadataByIndexedField や ReplicaMetadata..::..FindItemMetadataByUniqueIndexedFields などのメソッドで使用できます。