MessageVersion 类

定义

命名空间:

System.ServiceModel.Channels

程序集:

System.ServiceModel.Primitives.dll

程序集:

System.ServiceModel.dll

指定与消息及其交换相关联的 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

继承

Object

MessageVersion

属性

TypeConverterAttribute

注解

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 日，WS-Addressing的 W3C 成员提交可在 Web 服务寻址 (WS 寻址) 。 2005 年 8 月 17 日 W3C 候选建议适用于 WS-Addressing 1.0 - 核心的 Web 服务提供核心。

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()	返回当前消息版本的字符串表示形式。