SqlMetadataStore.GetReplicaMetadata 메서드
메타데이터 저장소의 복제본 메타데이터에 액세스하는 데 사용되는 복제본 메타데이터 개체를 가져옵니다.
네임스페이스: Microsoft.Synchronization.MetadataStorage
어셈블리: microsoft.synchronization.metadatastorage.dll의 Microsoft.Synchronization.MetadataStorage
구문
‘선언
Public Overrides Function GetReplicaMetadata ( _
idFormats As SyncIdFormatGroup, _
replicaId As SyncId _
) As ReplicaMetadata
‘사용 방법
Dim instance As SqlMetadataStore
Dim idFormats As SyncIdFormatGroup
Dim replicaId As SyncId
Dim returnValue As ReplicaMetadata
returnValue = instance.GetReplicaMetadata(idFormats, replicaId)
public override ReplicaMetadata GetReplicaMetadata (
SyncIdFormatGroup idFormats,
SyncId replicaId
)
public:
virtual ReplicaMetadata^ GetReplicaMetadata (
SyncIdFormatGroup^ idFormats,
SyncId^ replicaId
) override
public ReplicaMetadata GetReplicaMetadata (
SyncIdFormatGroup idFormats,
SyncId replicaId
)
public override function GetReplicaMetadata (
idFormats : SyncIdFormatGroup,
replicaId : SyncId
) : ReplicaMetadata
매개 변수
- idFormats
공급자에 대한 ID 형식 스키마입니다.
- replicaId
이 메타데이터와 연결된 복제본의 ID입니다.
반환 값
메타데이터 저장소의 복제본 메타데이터에 액세스하는 데 사용되는 복제본 메타데이터 개체입니다.
예외
예외 형식 | 조건 |
---|---|
이 개체가 삭제되었거나, 올바르게 초기화되지 않았습니다. |
|
idFormats 또는 replicaId가 null 참조(Visual Basic에서는 Nothing)입니다. |
|
replicaId의 형식이 idFormats에 지정된 형식과 일치하지 않거나, idFormats가 복제본 메타데이터가 초기화될 때 사용된 ID 형식 스키마와 일치하지 않습니다. |
|
idFormats에 지정된 ID 길이가 8000바이트를 초과합니다. |
|
메타데이터 저장소를 열거나 만들지 않았습니다. |
|
이 복제본 메타데이터 개체의 인스턴스가 이미 활성 상태입니다. |
|
ID가 replicaId인 복제본 메타데이터를 찾을 수 없습니다. |
주의
이 메서드는 메타데이터 저장소에 이미 있는 복제본 메타데이터에 액세스하는 데 사용됩니다. 메타데이터 저장소에 새 복제본 메타데이터를 만들려면 InitializeReplicaMetadata를 사용합니다.
이 메서드는 Metadata Storage Service에서 제공하는 ReplicaMetadata 추상 클래스의 구현을 반환합니다. 이 추상 클래스를 사용하면 Sync Framework 데이터베이스 파일에 저장된 복제본 메타데이터에 액세스할 수 있습니다.
응용 프로그램이 메타데이터 저장소에 서로 충돌하는 업데이트 내용을 적용하지 않도록 특정 복제본 ID에 대해 처리 중인 ReplicaMetadata 인스턴스를 여러 개 사용할 수 없습니다. 응용 프로그램은 여러 스레드에서 동일한 ReplicaMetadata 개체에 액세스할 수 있지만 여러 프로세스에서 동시에 복제본 메타데이터에 액세스할 수 없습니다. 특정 복제본 ID에 대해 처리 중인 ReplicaMetadata 인스턴스가 이미 있는 경우 이 메서드는 ReplicaMetadataInUseException을 throw합니다.
참고 항목
참조
SqlMetadataStore 클래스
SqlMetadataStore 멤버
Microsoft.Synchronization.MetadataStorage 네임스페이스