テキスト ベースの XML メッセージに使用される文字エンコードとメッセージのバージョン管理を指定します。
<configuration>
<system.serviceModel>
<bindings>
<customBinding>
<binding>
<textMessageEncoding>
構文
<textMessageEncoding maxReadPoolSize="Integer"
maxWritePoolSize="Integer"
messageVersion="Soap11Addressing10/Soap12Addressing10"
writeEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding" />
属性および要素
以降のセクションでは、属性、子要素、および親要素について説明します。
Attributes
| 特性 | Description |
|---|---|
| maxReadPoolSize | 新しいリーダーを割り当てずに同時に読み取ることができるメッセージの数を指定する整数。 プール サイズが大きいほど、システムはより大きなワーキング セットを犠牲にしてアクティビティの急増に対する耐性を高めます。 既定値は 64 です。 |
| maxWritePoolSize | 新しいライターを割り当てずに同時に送信できるメッセージの数を指定する整数。 プール サイズが大きいほど、システムはより大きなワーキング セットを犠牲にしてアクティビティの急増に対する耐性を高めます。 既定の設定は 16 です。 |
| messageVersion | バインディングを使用して送信されるメッセージの SOAP バージョンを指定します。 有効な値は次のとおりです。 - Soap11Addressing10 - Soap12Addressing10 - Soap11 - Soap12 既定値は Soap12Addressing10 です。 この属性は MessageVersion型です。 |
| writeEncoding | バインディングでメッセージを出力するために使用する文字セット エンコードを指定します。 有効な値は次のとおりです。 - UnicodeFffeTextEncoding: Unicode BigEndian エンコード - Utf16TextEncoding: Unicode エンコード - Utf8TextEncoding: 8 ビット エンコード 既定値は Utf8TextEncoding です。 この属性は Encoding型です。 |
子要素
| 要素 | Description |
|---|---|
| <readerQuotas> | このバインディングで構成されたエンドポイントによって処理できる SOAP メッセージの複雑さに関する制約を定義します。 この要素は XmlDictionaryReaderQuotasElement型です。 |
親要素
| 要素 | Description |
|---|---|
| <バインディング> | カスタム バインドのすべてのバインド機能を定義します。 |
注釈
エンコードは、メッセージをバイト シーケンスに変換するプロセスです。 デコードは逆のプロセスです。 Windows Communication Foundation (WCF) には、SOAP メッセージの 3 種類のエンコードが含まれています。テキスト、バイナリ、メッセージ送信の最適化メカニズム (MTOM) です。
textMessageEncoding要素によって表されるテキスト エンコードは、最も相互運用可能ですが、XML メッセージの最も効率的なエンコーダーです。 テキスト エンコーダーは、ネットワーク上にテキスト ベースのメッセージを作成します。 このエンコーダーによって生成されるメッセージは、WS-* ベースの相互運用に適しています。 Web サービスまたは Web サービス クライアントは、一般にテキスト XML を理解できます。 ただし、バイナリ データの大きなブロックをテキストとして送信することは、XML メッセージをエンコードするための最も効率的な方法ではありません。
Example
<textMessageEncoding maxReadPoolSize="211"
maxWritePoolSize="2132"
messageVersion="Soap12Addressing10"
textEncoding="utf-8" />
こちらも参照ください
.NET