XmlMessageFormatter.TargetTypeNames 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
제공된 메시지에서 포맷터에 의해 역직렬화될 가능한 형식의 집합을 지정합니다.
public:
property cli::array <System::String ^> ^ TargetTypeNames { cli::array <System::String ^> ^ get(); void set(cli::array <System::String ^> ^ value); };
[System.Messaging.MessagingDescription("XmlMsgTargetTypeNames")]
public string[] TargetTypeNames { get; set; }
[<System.Messaging.MessagingDescription("XmlMsgTargetTypeNames")>]
member this.TargetTypeNames : string[] with get, set
Public Property TargetTypeNames As String()
속성 값
메시지를 읽을 때 메시지 본문에서 역직렬화할 개체의 형식을 지정하는 형식 String 의 배열입니다.
- 특성
예외
TargetTypeNames 속성은 null입니다.
설명
TargetTypeNames TargetTypes 두 속성 모두 메시지를 역직렬화할 때 일치시킬 스키마를 포맷터에 알려줍니다. 이렇게 하면 포맷터가 메시지 본문을 해석할 수 있습니다.
메시지 본문에 직렬화된 인스턴스는 형식 배열에 표시되는 스키마 중 하나를 준수해야 합니다. 메서드를 사용하여 Receive 메시지를 읽을 때 메서드는 식별된 스키마에 해당하는 형식의 개체를 만들고 메시지 본문을 읽습니다.
큐에서 읽을 때는 두 속성 중 하나만 설정해야 하지만 둘 다 설정할 수 있습니다. 형식 집합은 두 속성에서 결합된 집합입니다. 사용할 속성에 대한 결정은 애플리케이션에 따라 결정됩니다. 메시지 본문에 스키마가 두 속성의 배열 형식 중 하나와 일치하지 않는 형식이 포함되어 있으면 메시지를 읽을 때 예외가 throw됩니다.
TargetTypeNames 에서는 모든 항목이 정규화되고 해당 어셈블리 이름을 지정해야 합니다. 또한 여러 동시 버전으로 작업하는 경우 대상 형식 이름에도 버전 번호를 추가해야 합니다.
대상 형식은 큐에서 읽을 때만 필요합니다. 큐에 TargetTypeNames 쓰기 위해 속성 및 TargetTypes 속성을 설정할 필요가 없습니다.