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.
注解
和TargetTypeNamesTargetTypes属性都告诉格式化程序反序列化消息时要尝试匹配的架构。 这允许格式化程序解释消息正文。
消息正文中序列化的实例必须符合类型数组中表示的架构之一。 使用 Receive 该方法读取消息时,该方法将创建一个与标识的架构相对应的类型的对象,并将消息正文读入其中。
从队列中读取时,只需要设置两个属性中的一个,但你可以同时设置这两个属性。 类型集是两个属性的组合集。 要使用的属性的决定特定于应用程序。 如果消息正文包含一个类型,其架构与任一属性的数组中的任何类型不匹配,则读取消息时将引发异常。
TargetTypeNames 要求每个条目都完全限定,并指定其程序集名称。 此外,在使用多个并发版本时,版本号也必须追加到目标类型名称。
仅当从队列中读取时,才需要目标类型。 TargetTypeNames不需要将和TargetTypes属性设置为写入队列。