<mtomMessageEncoding>

Статья
02/28/2011

Определяет метод шифрования и управления версиями сообщений для сообщений, использующих механизм оптимизации передачи сообщений SOAP (MTOM).

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

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

Синтаксис

<mtomMessageEncoding 
   maxBufferSize="Integer"
      maxReadPoolSize="Integer"
   maxWritePoolSize="Integer"
   messageVersion="Soap11Addressing1/Soap12Addressing10"
      writeEncoding=”UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding" />

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

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

Атрибуты

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

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

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

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

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

Замечания

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

Элемент MtomMessageEncoding указывает кодировку символов, управление версиями сообщений и другие параметры для сообщений, использующих кодировку MTOM. MTOM — это эффективный способ передачи двоичных данных в сообщениях WCF. Кодировщик MTOM пытается сохранить баланс между эффективностью и совместимостью. При кодировке MTOM большая часть XML-кода передается в текстовой форме, однако выполняется оптимизация больших блоков двоичных данных путем передачи их в исходном виде, без преобразования их в базовый формат base64.

Пример

<mtomMessageEncoding maxReadPoolSize="211"
    maxWritePoolSize="2132"
    messageVersion=”Soap11Addressing10”
    textEncoding=”utf-8” />

См. также

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