Udostępnij przez


<mtomMessageEncoding>

Określa kodowanie i przechowywanie wersji komunikatów używanych dla komunikatów opartych na protokole SOAP Message Transmission Optimization Mechanism (MTOM).

<configuration>
  <system.serviceModel>
    <bindings>
      <customBinding>
        <binding>
          <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.

Attributes

Attribute Description
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 wzrost 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 wzrost aktywności kosztem większego zestawu roboczego. Wartość domyślna to 16.
messageVersion (wersja komunikatu) 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

Składnik Description
<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

Składnik Description
<wiążący> 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: Text, Binary and Message Transmission Optimization Mechanism (MTOM).

Element MtomMessageEncoding określa kodowanie znaków i przechowywanie wersji komunikatów oraz inne ustawienia używane dla komunikatów przy użyciu kodowania mechanizmu optymalizacji transmisji komunikatów (MTOM). MTOM to wydajna technologia 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 as-is, bez konwersji na format zakodowany w formacie base64.

Example

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

Zobacz także