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) 都有類似列舉的語意 (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() |
傳回目前訊息版本的字串表示。 |