MessageVersion 类

定义

指定与消息及其交换相关联的 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”属性(如 Soap11WSAddressing10Soap12)都具有类似于枚举的语义。 它们提供 Windows Communication Foundation (WCF) 运行时支持的可能消息版本的枚举。 消息具有某种信封结构和某种寻址结构。 MessageVersion 只是同时提供 {EnvelopeVersion, AddressingVersion} 的一种快捷方式。

目前,有两个 SOAP 信封版本可用:SOAP 1.1 和 SOAP 1.2。 SOAP 的这些版本由 EnvelopeVersion 表示,并由 Soap11Soap12 属性返回。 与 MessageVersion 关联的 SOAP 版本可以通过使用 Envelope 属性进行恢复。 有关详细信息,请参阅 SOAP 1.1SOAP 1.2 的架构。

目前,有两个 WS-Addressing 版本可用。 一个是 2004 年 8 月 10 日提交的版本,另一个是在 WS-Addressing 1.0 协议中指定的版本。 当前消息版本所用的地址版本可通过 Addressing 属性进行恢复。 WS-Addressing 的这些版本由 AddressingVersion 表示,并由 WSAddressingAugust2004WSAddressing10 属性返回。 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()

返回当前消息版本的字符串表示形式。

适用于