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 屬性傳回。 您可以使用 Envelope 屬性來復原與 MessageVersion 相關聯的 SOAP 版本。 如需詳細資訊,請參閱 SOAP 1.1 和 SOAP 1.2的架構。
目前有兩個版本的 WS-Addressing 可用。 2004 年 8 月 10 日提交的 ,以及 WS-Addressing 1.0 通訊協定中指定的。 目前訊息版本所使用的位址版本可以使用 Addressing 屬性來復原。 這些版本的 WS-Addressing 會以 AddressingVersion 表示,並由 WSAddressingAugust2004 和 WSAddressing10 屬性傳回。 WS-Addressing 2004 年 8 月會保留為舊版值。 2004 年 8 月 10 日 W3C 成員提交 WS-Addressing 可在 Web 服務尋址 (WS-Addressing)取得。 2005 年 8 月 17 日 W3C 候選 WS-Addressing 1.0 - 核心建議可在 Web 服務尋址 1.0 - Core取得。
None 提供使用「純舊 XML」(POX)樣式傳訊的支援。 啟用基本的 POX 傳訊現在就是使用使用 None的文字編碼器,在您的服務上設定 HTTP 系結。
您可以使用指定版本的 WS-Addressing 和 SOAP,使用其中一個 CreateVersion 多載來建立訊息版本物件。
屬性
Addressing |
取得或設定與目前訊息版本相關聯的 WS-Addressing 版本。 |
Default |
取得 Windows Communication Foundation (WCF) 所使用的預設訊息版本。 |
Envelope |
取得與目前訊息版本相關聯的SOAP版本。 |
None |
取得不使用SOAP或 WS 尋址的訊息版本。 |
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 月和 SOAP 1.2 提交的 WS-Addressing 取得訊息版本。 |
方法
CreateVersion(EnvelopeVersion, AddressingVersion) |
使用指定的 SOAP 和 WS-Addressing 版本建立訊息版本物件。 |
CreateVersion(EnvelopeVersion) |
使用 WS-Addressing 1.0 和指定的 SOAP 版本建立訊息版本物件。 |
Equals(Object) |
傳回值,這個值表示目前的訊息版本是否等於指定的物件。 |
GetHashCode() |
取得目前訊息版本的哈希碼。 |
GetType() |
取得目前實例的 Type。 (繼承來源 Object) |
MemberwiseClone() |
建立目前 Object的淺層複本。 (繼承來源 Object) |
ToString() |
傳回目前訊息版本的字串表示。 |