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) 都有類似列舉的語意 (Semantics)。 它們提供 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 屬性傳回。 2004 年 8 月發表的 WS-Addressing 保留為舊版的值。 WS-Addressing的 2004 年 8 月 10 日 W3C 成員提交可在 Web 服務定址 (WS 定址) 取得。 2005 年 8 月 17 日適用于 WS-Addressing 1.0 - 核心的 W3C 候選建議位於 網址 1.0 - 核心的 Web 服務。

None 提供使用「純舊 XML」 (POX) 樣式傳訊的支援。 啟用基本 POX 傳訊現在與在服務上設定 HTTP 繫結有關，其中包含使用 None 的文字編碼器。

可以使用指定版本的 WS-Addressing 和 SOAP (利用其中一個 CreateVersion 多載) 來建立訊息版本物件。

屬性

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()	傳回目前訊息版本的字串表示。