System.Runtime.Serialization.IExtensibleDataObject 인터페이스

이 문서는 이 API에 대한 참조 설명서를 보충하는 추가 설명을 제공합니다.

인터페이스는 IExtensibleDataObject 데이터 계약 외부에 있는 데이터를 저장하는 데 사용되는 구조를 설정하거나 반환하는 단일 속성을 제공합니다. 추가 데이터는 클래스의 ExtensionDataObject 인스턴스에 저장되고 속성을 통해 ExtensionData 액세스됩니다. 데이터가 수신, 처리 및 다시 전송되는 왕복 작업에서 추가 데이터는 원래 보낸 사람에게 그대로 다시 전송됩니다. 이는 이후 버전의 계약에서 받은 데이터를 저장하는 데 유용합니다. 인터페이스를 구현하지 않으면 왕복 작업 중에 추가 데이터가 무시되고 삭제됩니다.

이 버전 관리 기능을 사용하려면

1. 클래스에서 IExtensibleDataObject 인터페이스를 구현합니다.

2. 형식에 ExtensionData 속성을 추가합니다.

3. 클래스에 형식 ExtensionDataObject 의 프라이빗 멤버를 추가합니다.

4. 새 프라이빗 멤버를 사용하여 속성에 대한 get 및 set 메서드를 구현합니다.

5. 클래스에 DataContractAttribute 특성을 적용합니다. Name 및 Namespace 속성을 필요한 경우 적절한 값으로 설정합니다.

형식의 버전 관리에 대한 자세한 내용은 데이터 계약 버전 관리를 참조하세요. 정방향 호환 데이터 계약을 만드는 방법에 대한 자세한 내용은 Forward-Compatible 데이터 계약을 참조하세요. 데이터 계약에 대한 자세한 내용은 데이터 계약 사용을 참조하세요.