다음을 통해 공유

MetadataStore.InitializeReplicaMetadata 메서드

  • 아티클

파생 클래스에서 재정의되면 복제본의 메타데이터를 새로 만들고 초기화하여 저장합니다.

네임스페이스: Microsoft.Synchronization.MetadataStorage
어셈블리: microsoft.synchronization.metadatastorage.dll의 Microsoft.Synchronization.MetadataStorage

구문

‘선언
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

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

매개 변수

  • idFormats
    공급자에 대한 ID 형식 스키마입니다.
  • replicaId
    생성 및 초기화 중인 메타데이터에서 나타내는 복제본의 복제본 ID입니다.
  • customItemFieldSchemas
    메타데이터 항목과 연결된 사용자 지정 메타데이터 필드를 설명하는 스키마 정보입니다. 사용자 지정 메타데이터 필드가 없으면 null 참조(Visual Basic에서는 Nothing)이 될 수 있습니다.
  • customIndexedFieldSchemas
    메타데이터 저장소에 있는 항목을 보다 효율적으로 찾기 위해 사용할 수 있는 인덱스 스키마 목록입니다. 인덱스 스키마가 없으면 null 참조(Visual Basic에서는 Nothing)이 될 수 있습니다.

반환 값

새로 만든 복제본 메타데이터를 나타내는 ReplicaMetadata 개체입니다.

예외

예외 형식 조건

SyncIdFormatMismatchException

idFormats로 지정된 ID 형식 스키마가 복제본 메타데이터를 초기화하는 데 사용된 스키마와 일치하지 않습니다.

주의

이 메서드는 반환된 ReplicaMetadata 개체를 즉시 사용하여 메타데이터에 액세스하고 해당 메타데이터를 수정할 수 있도록 복제본 메타데이터를 만들고 초기화하는 데 필요한 모든 태스크를 메타데이터 저장소에서 수행해야 합니다.

customItemFieldSchemas를 사용하여 항목 메타데이터에 대한 사용자 지정 필드 집합을 정의할 수 있습니다. 각 필드는 고유 문자열 이름 및 값으로 구성되어 있습니다. 이러한 필드를 사용하여 기본 항목 메타데이터 집합에서 지원하지 않는 항목에 대한 추가 메타데이터를 저장할 수 있습니다. 이 필드는 ItemMetadata에 있는 ItemMetadata.GetByteField 또는 Microsoft.Synchronization.MetadataStorage.ItemMetadata.SetCustomField와 같은 다양한 메서드를 사용하여 액세스할 수 있습니다.

사용자 지정 필드 집합을 메타데이터 저장소의 항목을 효율적으로 찾기 위한 인덱스로 사용할 수 있도록 customIndexedFieldSchemas를 사용하여 인덱스 스키마 집합을 정의할 수 있습니다. 인덱스 스키마를 고유한 것으로 정의하여 해당 인덱스가 단일 항목을 정의하도록 할 수 있습니다. 인덱스 스키마에 포함된 각 필드는 복제본에 대해 정의된 사용자 지정 필드 스키마에도 있어야 합니다. 인덱스 필드는 ReplicaMetadata.FindItemMetadataByIndexedField 및 ReplicaMetadata.FindItemMetadataByUniqueIndexedFields와 같은 메서드에 사용할 수 있습니다.

참고 항목

참조

MetadataStore 클래스
MetadataStore 멤버
Microsoft.Synchronization.MetadataStorage 네임스페이스