MtomMessageEncodingBindingElement クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
メッセージ転送最適化メカニズム (MTOM) メッセージに使用されるエンコードとバージョン管理を指定するバインディング要素。
public ref class MtomMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElementpublic ref class MtomMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement, System::ServiceModel::Description::IPolicyExportExtension, System::ServiceModel::Description::IWsdlExportExtensionpublic sealed class MtomMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElementpublic sealed class MtomMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement, System.ServiceModel.Description.IPolicyExportExtension, System.ServiceModel.Description.IWsdlExportExtensiontype MtomMessageEncodingBindingElement = class
inherit MessageEncodingBindingElementtype MtomMessageEncodingBindingElement = class
inherit MessageEncodingBindingElement
interface IWsdlExportExtension
interface IPolicyExportExtensionPublic NotInheritable Class MtomMessageEncodingBindingElement
Inherits MessageEncodingBindingElementPublic NotInheritable Class MtomMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Implements IPolicyExportExtension, IWsdlExportExtension- 継承
- 実装
注釈
エンコードは、メッセージをバイト シーケンスに変換するプロセスです。 デコードは逆のプロセスです。 Windows Communication Foundation (WCF) には、SOAP メッセージの 3 種類のエンコードが含まれています。テキスト、バイナリ、メッセージ送信の最適化メカニズム (MTOM) です。
MtomMessageEncodingBindingElementは、メッセージ転送最適化メカニズム (MTOM) エンコードを使用してメッセージに使用される文字エンコードとメッセージのバージョン管理およびその他の設定を指定するバインディング要素を表します。 MTOM は、WCF メッセージでバイナリ データを送信するための効率的なテクノロジです。 MTOM エンコーダーは、効率と相互運用性のバランスを取ろうとします。 MTOM エンコードは、ほとんどの XML をテキスト形式で送信しますが、base64 でエンコードされた形式に変換することなく、as-is送信することでバイナリ データの大きなブロックを最適化します。
メッセージが XML のテキスト表現を使用してエンコードされることを指定するバインディング要素の詳細については、 TextMessageEncodingBindingElementを参照してください。
.NET Binary Format for XML を使用してエンコードされるメッセージを指定するバインド要素の詳細については、「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) |
指定したコンテキストに対して指定した種類のチャネルを受け入れるチャネル リスナー スタックをクライアント上に構築します。 |
| CanBuildChannelFactory<TChannel>(BindingContext) |
現在のバインディングが、指定した種類のチャネルとコンテキストのファクトリを構築できるかどうかを示す値を返します。 |
| CanBuildChannelListener<TChannel>(BindingContext) |
現在のバインディングが、指定した種類のチャネルとコンテキストのリスナーを構築できるかどうかを示す値を返します。 |
| 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 に挿入します。これは、MTOM エンコードが使用されていることを示します。 |
| IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext) |
MTOM 固有の情報の WSDL コントラクトを変更します。 |
| IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext) |
SOAP メッセージのバージョンを WSDL に格納します。 |
