<textMessageEncoding>

Задает кодировку символов и управление версиями сообщений, используемых для текстовых 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 Указывает кодировку набора символов, которая будет использоваться для создания сообщений в привязке. Допустимые значения:

- ЮникодFffeTextEncoding: кодировка Unicode BigEndian
- Utf16TextEncoding: кодировка Юникода
- Utf8TextEncoding: 8-разрядная кодировка

Значение по умолчанию — Utf8TextEncoding. Этот атрибут имеет тип Encoding.

Дочерние элементы

Элемент Description
<readerQuotas> Определяет ограничения сложности сообщений SOAP, которые могут обрабатываться конечными точками, настроенными с помощью этой привязки. Этот элемент имеет тип XmlDictionaryReaderQuotasElement.

Родительские элементы

Элемент Description
<связывание> Определяет все возможности привязки пользовательской привязки.

Замечания

Кодировка — это процесс преобразования сообщения в последовательность байтов. Декодирование — это обратный процесс. Windows Communication Foundation (WCF) включает три типа кодирования для сообщений SOAP: текстовый, двоичный и механизм оптимизации передачи сообщений (MTOM).

Кодировка текста, textMessageEncoding представленная элементом, является наиболее совместимым, но наименее эффективным кодировщиком для XML-сообщений. Кодировщик текста создает текстовые сообщения на основе провода. Сообщения, созданные этим кодировщиком, подходят для взаимодействия на основе WS*. Клиент веб-службы или веб-службы обычно может понять текстовый XML. Однако передача больших блоков двоичных данных в виде текста является наименее эффективным методом кодирования XML-сообщений.

Example

<textMessageEncoding maxReadPoolSize="211"
                     maxWritePoolSize="2132"
                     messageVersion="Soap12Addressing10"
                     textEncoding="utf-8" />

См. также

  • Last updated on