MessageVersion クラス

定義

名前空間:

System.ServiceModel.Channels

アセンブリ:

System.ServiceModel.Primitives.dll

パッケージ:

System.ServiceModel.Primitives v8.0.0

ソース:

MessageVersion.cs

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

public ref class MessageVersion sealed

public sealed class MessageVersion

type MessageVersion = class

Public NotInheritable Class MessageVersion

継承

Object

MessageVersion

注釈

MessageVersion には、SOAP エンベロープと、メッセージが使用するアドレス指定プロトコルの両方に関する、バージョン管理情報が格納されます。 Message のインスタンスは、MessageVersion のいずれかのオーバーロードに対するパラメーターとしてバージョンを渡すことで、作成時に特定の CreateMessage に対してバインドします。

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

現在、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()	現在のメッセージ バージョンの文字列形式を返します。