MessageVersion 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
指定与消息及其交换相关联的 SOAP 和 WS-Addressing 的版本。
public ref class MessageVersion sealed
public sealed class MessageVersion
[System.ComponentModel.TypeConverter(typeof(System.ServiceModel.Configuration.MessageVersionConverter))]
public sealed class MessageVersion
type MessageVersion = class
[<System.ComponentModel.TypeConverter(typeof(System.ServiceModel.Configuration.MessageVersionConverter))>]
type MessageVersion = class
Public NotInheritable Class MessageVersion
- 继承
-
MessageVersion
- 属性
注解
MessageVersion 包含消息所用的 SOAP 信封和寻址协议的版本信息。 通过将版本作为参数传递到 Message 重载之一,MessageVersion 的实例在创建时绑定到特定 CreateMessage。
此类中的所有静态“get”属性(如 Soap11WSAddressing10 和 Soap12)都具有类似于枚举的语义。 它们提供 Windows Communication Foundation (WCF) 运行时支持的可能消息版本的枚举。 消息具有某种信封结构和某种寻址结构。 MessageVersion 只是同时提供 {EnvelopeVersion, AddressingVersion} 的一种快捷方式。
目前,有两个 SOAP 信封版本可用:SOAP 1.1 和 SOAP 1.2。 SOAP 的这些版本由 EnvelopeVersion 表示,并由 Soap11 和 Soap12 属性返回。 与 MessageVersion 关联的 SOAP 版本可以通过使用 Envelope 属性进行恢复。 有关详细信息,请参阅 SOAP 1.1 和 SOAP 1.2 的架构。
目前,有两个 WS-Addressing 版本可用。 一个是 2004 年 8 月 10 日提交的版本,另一个是在 WS-Addressing 1.0 协议中指定的版本。 当前消息版本所用的地址版本可通过 Addressing 属性进行恢复。 WS-Addressing 的这些版本由 AddressingVersion 表示,并由 WSAddressingAugust2004 和 WSAddressing10 属性返回。 WS-Addressing August 2004 已作为旧值保留。 2004 年 8 月 10 日 W3C 成员提交 WS-Addressing,请参阅 Web 服务寻址 (WS 寻址) 。 2005 年 8 月 17 日 W3C WS-Addressing 1.0 核心候选建议在 Web 服务寻址 1.0 - 核心版中提供。
None 支持使用“普通旧 XML” (POX) 样式的消息传送。 这样,启用基本 POX 消息传递就只是在服务上与使用 None 的文本编码器建立 HTTP 绑定。
消息版本对象可以使用 CreateVersion 重载之一以及指定版本的 WS-Addressing 和 SOAP 进行创建。
属性
Addressing |
获取或设置与当前消息版本关联的 WS-Addressing 版本。 |
Default |
获取 Windows Communication Foundation (WCF) 使用的默认消息版本。 |
Envelope |
获取与当前消息版本关联的 SOAP 版本。 |
None |
获取不使用 SOAP 或 WS-Addressing 的消息版本。 |
Soap11 |
获取使用 SOAP 1.1 的消息版本。 |
Soap11WSAddressing10 |
获取使用 WS-Addressing 1.0 和 SOAP 1.1 的消息版本。 |
Soap11WSAddressingAugust2004 |
通过使用 2004 年 8 月 10 日提交的 WS-Addressing 和 SOAP 1.1 来获取消息版本。 |
Soap12 |
获取使用 SOAP 1.2 的消息版本。 |
Soap12WSAddressing10 |
获取使用 WS-Addressing 1.0 和 SOAP 1.2 的消息版本。 |
Soap12WSAddressingAugust2004 |
获取消息版本,该消息版本使用 2004 年 8 月提交的 WS-Addressing 和 SOAP 1.2。 |
方法
CreateVersion(EnvelopeVersion) |
使用 WS-Addressing 1.0 和指定的 SOAP 版本创建消息版本对象。 |
CreateVersion(EnvelopeVersion, AddressingVersion) |
使用指定的 SOAP 和 WS-Addressing 版本创建消息版本对象。 |
Equals(Object) |
返回一个值,该值指示当前消息版本与指定对象是否相等。 |
GetHashCode() |
获取当前消息版本的哈希代码。 |
GetType() |
获取当前实例的 Type。 (继承自 Object) |
MemberwiseClone() |
创建当前 Object 的浅表副本。 (继承自 Object) |
ToString() |
返回当前消息版本的字符串表示形式。 |