다음을 통해 공유

SqlSyncMetadataStoreSerializer.DeserializeReplicaMetadata 메서드

  • 아티클

정식 메타데이터 파일의 내용을 Metadata Storage Service 저장소로 역직렬화합니다. 공급자 버전이 변경될 경우 필요에 따라 메타데이터 저장소 형식을 업그레이드할 수도 있습니다.

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

구문

‘선언
Public Overrides Function DeserializeReplicaMetadata ( _
    serializedFilePath As String, _
    expectedProviderCompatibilityVersion As UInteger, _
    providerUpgradeCallback As IProviderUpgradeCallback _
) As Boolean
‘사용 방법
Dim instance As SqlSyncMetadataStoreSerializer
Dim serializedFilePath As String
Dim expectedProviderCompatibilityVersion As UInteger
Dim providerUpgradeCallback As IProviderUpgradeCallback
Dim returnValue As Boolean

returnValue = instance.DeserializeReplicaMetadata(serializedFilePath, expectedProviderCompatibilityVersion, providerUpgradeCallback)

public override bool DeserializeReplicaMetadata (
    string serializedFilePath,
    uint expectedProviderCompatibilityVersion,
    IProviderUpgradeCallback providerUpgradeCallback
)

public:
virtual bool DeserializeReplicaMetadata (
    String^ serializedFilePath, 
    unsigned int expectedProviderCompatibilityVersion, 
    IProviderUpgradeCallback^ providerUpgradeCallback
) override

public boolean DeserializeReplicaMetadata (
    String serializedFilePath, 
    UInt32 expectedProviderCompatibilityVersion, 
    IProviderUpgradeCallback providerUpgradeCallback
)

public override function DeserializeReplicaMetadata (
    serializedFilePath : String, 
    expectedProviderCompatibilityVersion : uint, 
    providerUpgradeCallback : IProviderUpgradeCallback
) : boolean

매개 변수

  • serializedFilePath
    특정 복제본에 대한 직렬화된 메타데이터를 포함하는 파일입니다.
  • expectedProviderCompatibilityVersion
    정식 메타데이터 파일에 포함될 것으로 예상되는 공급자 호환성 버전입니다. 예상 버전이 실제 버전과 일치하지 않는 경우 providerUpgradeCallback이 null 참조(Visual Basic에서는 Nothing)이면 역직렬화가 기본적으로 실패합니다. providerUpgradeCallback이 null 참조(Visual Basic에서는 Nothing)이 아니면 providerUpgradeCallback 메서드가 호출됩니다. 자세한 내용은 버전이 다른 구성 요소의 메타데이터 액세스 및 메타데이터 저장소 버전 업그레이드를 참조하십시오.
  • providerUpgradeCallback
    직렬화된 메타데이터에 포함된 공급자 버전이 expectedProviderCompatibilityVersion과 같지 않기 때문에 메타데이터 저장소 형식을 업그레이드해야 할 때 호출되는 콜백 메서드입니다.

반환 값

역직렬화할 메타데이터가 있으면 true이고, 그렇지 않으면 false입니다.

예외

예외 형식 조건

ArgumentNullException

필수 매개 변수가 null 참조(Visual Basic에서는 Nothing)입니다.

ArgumentException

serializedFilePath가 빈 문자열입니다.

ExplicitTransactionRequiredException

메타데이터를 역직렬화할 트랜잭션을 사용할 수 없습니다.

MetadataStoreProviderVersionMismatchException

expectedProviderCompatibilityVersion에 지정된 공급자 호환성 버전이 정식 메타데이터 파일에 지정된 버전과 일치하지 않고 providerUpgradeCallback이 null 참조(Visual Basic에서는 Nothing)입니다.

SyncInvalidOperationException

메타데이터 저장소가 열리지 않았습니다.

주의

이 메서드를 호출하려면 다음 세 조건이 충족되어야 합니다.

  • 메타데이터 저장소가 열려 있어야 합니다. OpenStore 또는 CreateStore를 호출하여 저장소를 엽니다.

  • 데이터가 역직렬화되는 복제본의 메타데이터 저장소가 이미 초기화되어 있어야 합니다. 메타데이터 저장소를 초기화하려면 InitializeReplicaMetadata를 호출합니다.

  • SqlMetadataStore 개체에서 활성 트랜잭션을 사용할 수 있어야 합니다. BeginTransaction을 호출하여 트랜잭션을 시작합니다.

위의 세 조건 중 하나라도 충족되지 않는 경우 이 메서드를 호출하면 예외가 발생합니다.

이 메서드를 프로시저의 일부로 사용하여 공급자 버전이 변경될 때 메타데이터 스키마를 업그레이드할 수 있습니다. 자세한 내용은 메타데이터 저장소 버전 업그레이드를 참조하십시오.

참고 항목

참조

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