次の方法で共有


MessageVersion クラス

定義

メッセージとその交換に関連付けられている SOAP と WS アドレス指定のバージョンを指定します。

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" プロパティには、列挙に似たセマンティクスがあります。 これらは、Windows Communication Foundation (WCF) ランタイムでサポートされている可能性のあるメッセージ バージョンの列挙を提供します。 1 つのメッセージには、エンベロープ構造の部分とアドレス指定構造の部分があります。 MessageVersion は、{EnvelopeVersionAddressingVersion} をまとめて提供するためのショートカットです。

現在、SOAP エンベロープには、SOAP 1.1 と SOAP 1.2 の 2 つのバージョンがあります。 SOAP のこれらのバージョンは EnvelopeVersion で表され、Soap11 プロパティおよび Soap12 プロパティから返されます。 MessageVersion に関連付けられている SOAP のバージョンは、Envelope プロパティを使用して回復できます。 詳細については、 SOAP 1.1 と SOAP 1.2 のスキーマに関 するページを参照してください。

現在、2 つのバージョンの WS-Addressing を利用できます。 1 つは 2004 年 8 月 10 日に提出されたもので、もう 1 つは WS-Addressing 1.0 プロトコルで指定されているものです。 現在のメッセージ バージョンで使用されているアドレス バージョンは、Addressing プロパティを使用して回復できます。 これらのバージョンの WS-Addressing は、AddressingVersion によって表され、WSAddressingAugust2004 プロパティと WSAddressing10 プロパティで返されます。 2004 年 8 月版の WS-Addressing は、レガシ値として保持されています。 2004 年 8 月 10 日、WS-Addressing の W3C メンバー申請は 、Web サービス アドレッシング (WS-Addressing) で入手できます。 2005 年 8 月 17 日、WS-Addressing 1.0 - Core に関する W3C 候補の推奨事項は、 Web サービスのアドレス指定 1.0 - Core で入手できます。

None では、"plain old XML" (POX) スタイルのメッセージングの使用がサポートされています。 基本的な POX メッセージングを有効にするには、サービスの HTTP バインドに、None を使用するテキスト エンコーダーを設定します。

メッセージ バージョン オブジェクトは、いずれかの 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 月 10 日提出の 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()

現在のメッセージ バージョンの文字列形式を返します。

適用対象