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