<textMessageEncoding>

Статья
02/28/2011

Указывает кодировку символов и управление версиями сообщений для текстовых сообщений XML.

Иерархия схемы

<system.serviceModel>
  <bindings>
    <customBinding>
      <binding>
        <textMessageEncoding>

Синтаксис

<textMessageEncoding maxReadPoolSize="Integer"
   maxWritePoolSize="Integer"
   messageVersion="Soap11Addressing10/Soap12Addressing10"
      writeEncoding=”UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding" />

Атрибуты и элементы

В следующих разделах описываются атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут	Описание
maxReadPoolSize	Целое число, задающее количество сообщений, которые можно читать одновременно, не выделяя памяти для новых модулей чтения. Пулы больших размеров повышают устойчивость системы к всплескам активности за счет большего рабочего набора. Значение по умолчанию — 64.
maxWritePoolSize	Целое число, задающее количество сообщений, которые можно отправлять одновременно, не выделяя памяти для новых модулей записи. Пулы больших размеров повышают устойчивость системы к всплескам активности за счет большего рабочего набора. Значение по умолчанию — 16.
messageVersion	Задает версию SOAP сообщений, отправленных с помощью привязки. Допустимы следующие значения: Soap11Addressing10 Soap12Addressing10 Значение по умолчанию — Soap12Addressing10. Это атрибут типа MessageVersion.
writeEncoding	Задает кодировку, используемую при отправке сообщений через привязку. Допустимы следующие значения: UnicodeFffeTextEncoding: кодировка Юникод BigEndian Utf16TextEncoding: кодировка Юникод Utf8TextEncoding: 8-разрядная кодировка Значение по умолчанию — «Utf8TextEncoding». Это атрибут типа Encoding.

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

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

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

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

Замечания

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

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

Пример

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

См. также

Поделиться через