MtomMessageEncodingBindingElement クラス

定義

名前空間:

System.ServiceModel.Channels

アセンブリ:

System.ServiceModel.Primitives.dll

アセンブリ:

System.ServiceModel.dll

Message Transmission Optimization Mechanism (MTOM) メッセージに使用するエンコーディングおよびバージョン管理を指定するバインド要素。

public ref class MtomMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement

public ref class MtomMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement, System::ServiceModel::Description::IPolicyExportExtension, System::ServiceModel::Description::IWsdlExportExtension

public sealed class MtomMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement

public sealed class MtomMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement, System.ServiceModel.Description.IPolicyExportExtension, System.ServiceModel.Description.IWsdlExportExtension

type MtomMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement

type MtomMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement
    interface IWsdlExportExtension
    interface IPolicyExportExtension

Public NotInheritable Class MtomMessageEncodingBindingElement
Inherits MessageEncodingBindingElement

Public NotInheritable Class MtomMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Implements IPolicyExportExtension, IWsdlExportExtension

継承

Object

BindingElement

MessageEncodingBindingElement

MtomMessageEncodingBindingElement

実装

IPolicyExportExtension IWsdlExportExtension

注釈

エンコーディングは、メッセージをバイト シーケンスに変換するプロセスです。 デコードは、その逆のプロセスです。 WCF (Windows Communication Foundation) には、SOAP メッセージのエンコードとして、テキスト、バイナリ、および MTOM (Message Transmission Optimization Mechanism) の 3 種類があります。

MtomMessageEncodingBindingElement は、Message Transmission Optimization Mechanism (MTOM) エンコーディングを使用するメッセージに対する文字エンコーディングとメッセージのバージョン管理およびその他の設定を指定するバインド要素を表します。 MTOM は、WCF メッセージでバイナリ データを転送するための効率的なテクノロジです。 MTOM エンコーダーは、効率と相互運用性のバランスをとろうとします。 MTOM エンコーディングは、ほとんどの XML をテキスト形式で転送しますが、大きいサイズのバイナリ データ ブロックは、base64 でエンコードされた形式に変換せずに、そのまま転送することによって最適化します。

XML のテキスト表現を使用してメッセージをエンコードすることを指定するバインディング要素の詳細については、以下を参照してください TextMessageEncodingBindingElement。

メッセージを指定するバインディング要素の詳細については、XML 用 .NET Binary Format を使用してエンコードする方法を参照してください BinaryMessageEncodingBindingElement。

カスタム メッセージ エンコーダーを実装するには、MessageEncodingBindingElement クラスを使用します。

コンストラクター

MtomMessageEncodingBindingElement()	MtomMessageEncodingBindingElement クラスの新しいインスタンスを初期化します。
MtomMessageEncodingBindingElement(MessageVersion, Encoding)	指定したメッセージ バージョンと文字エンコーディングを使用して、MtomMessageEncodingBindingElement クラスの新しいインスタンスを初期化します。

プロパティ

MaxBufferSize	最大バッファー サイズを取得または設定します。
MaxReadPoolSize	受信メッセージの処理に使用できるようにプールに割り当てる XML リーダーの最大数を取得または設定します。
MaxWritePoolSize	送信メッセージの処理に使用できるようにプールに割り当てる XML ライターの最大数を取得または設定します。
MessageVersion	使用または予想される SOAP メッセージおよび WS-Addressing のバージョンを取得または設定します。
ReaderQuotas	このバインド要素を使用して設定されるエンドポイントにより処理可能な、XML メッセージの複雑さに対する制約を取得または設定します。
WriteEncoding	テキスト メッセージの文字の書式設定に使用されるエンコーディングを取得または設定します。

メソッド

BuildChannelFactory<TChannel>(BindingContext)	指定したコンテキストに対して指定した種類のチャネルを作成するチャネル ファクトリ スタックをクライアント上に作成します。
BuildChannelListener<TChannel>(BindingContext)	指定したコンテキストに対する、指定した種類のチャネルを受け入れるチャネル リスナー スタックをクライアント上に作成します。
BuildChannelListener<TChannel>(BindingContext)	指定した種類のチャネルを受け入れるよう、バインディング コンテキストからチャネル リスナーを初期化します。 (継承元 BindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)	指定した種類のチャネルとコンテキストに対するファクトリを現在のバインドが作成できるかどうかを示す値を返します。
CanBuildChannelListener<TChannel>(BindingContext)	指定した種類のチャネルとコンテキストに対するリスナーを現在のバインディングが作成できるかどうかを示す値を返します。
CanBuildChannelListener<TChannel>(BindingContext)	指定した種類のチャネルに対するリスナーをバインド要素が作成できるかどうかを示す値を返します。 (継承元 BindingElement)
Clone()	新しい MtomMessageEncodingBindingElement オブジェクトを作成し、現在のオブジェクトを使用して初期化します。
CreateMessageEncoderFactory()	MTOM メッセージをエンコードするメッセージ エンコーダー ファクトリを作成します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetProperty<T>(BindingContext)	バインディング要素スタックの適切な層から、要求のあった型指定されたオブジェクト (ある場合) を返します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ShouldSerializeMessageVersion()	SOAP メッセージ構造のバージョンをシリアル化する必要があるかどうかを示す値を返します。
ShouldSerializeReaderQuotas()	SOAP メッセージ構造の複雑さに対する制約をシリアル化する必要があるかどうかを示す値を返します。
ShouldSerializeWriteEncoding()	メッセージの文字の書式設定に使用される Encoding をシリアル化する必要があるかどうかを示す値を返します。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

明示的なインターフェイスの実装

IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext)	WSDL の生成時に WSDL にポリシー アサーションを挿入し、MTOM エンコーディングが使用されていることを示します。
IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext)	MTOM 固有の情報用に WSDL コントラクトを変更します。
IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext)	SOAP メッセージのバージョンを WSDL に格納します。