<mtomMessageEncoding>

Artykuł
06/08/2023

Określa kodowanie i przechowywanie wersji komunikatów używanych dla komunikatów opartych na mechanizmie optymalizacji transmisji komunikatów protokołu SOAP (MTOM).

<Konfiguracji>
  <System.servicemodel>
    <Powiązania>
      <Custombinding>
        <Wiązania>
          <mtomMessageEncoding>

Składnia

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

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.

Atrybuty

Atrybut	Opis
Maxbuffersize	Liczba całkowita określająca maksymalny rozmiar buforu, który może być używany.
maxReadPoolSize	Liczba całkowita określająca, ile komunikatów można odczytywać jednocześnie bez przydzielania nowych czytników. Większe rozmiary puli sprawiają, że system jest bardziej odporny na skoki aktywności kosztem większego zestawu roboczego. Wartość domyślna to 64.
Maxwritepoolsize	Liczba całkowita określająca, ile komunikatów można wysyłać jednocześnie bez przydzielania nowych składników zapisywania. Większe rozmiary puli sprawiają, że system jest bardziej odporny na skoki aktywności kosztem większego zestawu roboczego. Wartość domyślna to 16.
Messageversion	Określa wersję protokołu SOAP komunikatów wysyłanych przy użyciu powiązania. Prawidłowe wartości to - Soap11Addressing1 - Soap12Addressing10 Wartość domyślna to Soap12Addressing10. Ten atrybut jest typu MessageVersion.
writeEncoding	Określa kodowanie zestawu znaków, które ma być używane do emitowania komunikatów w powiązaniu. Prawidłowe wartości to - UnicodeFffeTextEncoding: Kodowanie Unicode BigEndian - Utf16TextEncoding: kodowanie Unicode - Utf8TextEncoding: kodowanie 8-bitowe Wartość domyślna to Utf8TextEncoding. Ten atrybut jest typu Encoding.

Elementy podrzędne

Element	Opis
<Readerquotas>	Definiuje ograniczenia dotyczące złożoności komunikatów protokołu SOAP, które mogą być przetwarzane przez punkty końcowe skonfigurowane za pomocą tego powiązania. Ten element jest typu XmlDictionaryReaderQuotasElement.

Elementy nadrzędne

Element	Opis
<Wiązania>	Definiuje wszystkie możliwości powiązania niestandardowego.

Uwagi

Kodowanie to proces przekształcania komunikatu w sekwencję bajtów. Dekodowanie jest procesem odwrotnym. Program Windows Communication Foundation (WCF) zawiera trzy typy kodowania komunikatów PROTOKOŁU SOAP: mechanizm optymalizacji tekstu, binarnej i transmisji komunikatów (MTOM).

Element MtomMessageEncoding określa kodowanie znaków i przechowywanie wersji komunikatów oraz inne ustawienia używane do obsługi komunikatów przy użyciu kodowania mechanizmu optymalizacji transmisji komunikatów (MTOM). MTOM to wydajna technologia do przesyłania danych binarnych w komunikatach WCF. Koder MTOM próbuje utworzyć równowagę między wydajnością a współdziałaniem. Kodowanie MTOM przesyła większość kodu XML w postaci tekstowej, ale optymalizuje duże bloki danych binarnych, przesyłając je zgodnie z rzeczywistym użyciem, bez konwersji na format zakodowany w formacie Base64.

Przykład

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