<mtomMessageEncoding>

Статья
06/08/2023

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

<Конфигурации>
  <system.serviceModel>
    <Привязки>
      <Custombinding>
        <Привязки>
          <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	Задает кодировку, используемую при отправке сообщений через привязку. Допустимы следующие значения: — ЮникодFffeTextEncoding: кодировка Юникода BigEndian — Utf16TextEncoding: кодировка Юникода — Utf8TextEncoding: 8-битовое кодирование Значение по умолчанию - Utf8TextEncoding. Это атрибут типа Encoding.

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

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

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

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

Кодирование — это процесс преобразования сообщения в последовательность байтов. Декодирование представляет собой обратный процесс. В 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" />

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