<textMessageEncoding>

Artykuł
06/08/2023

Określa kodowanie znaków i przechowywanie wersji komunikatów używanych dla komunikatów XML opartych na tekście.

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

Składnia

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

Atrybuty i elementy

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

Atrybuty

Atrybut	Opis
maxReadPoolSize	Liczba całkowita określająca liczbę komunikatów, które mogą być odczytywane 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	Określa wersję protokołu SOAP komunikatów wysyłanych przy użyciu powiązania. Prawidłowe wartości to - Soap11Addressing10 - Soap12Addressing10 - Soap11 - Soap12 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 SOAP: Mechanizm optymalizacji tekstu, binarnej i transmisji komunikatów (MTOM).

Kodowanie tekstu reprezentowane przez textMessageEncoding element jest najbardziej współdziałanie, ale najmniej wydajny koder dla komunikatów XML. Koder tekstowy tworzy komunikaty oparte na tekście na przewodach. Komunikaty generowane przez ten koder są odpowiednie dla międzyoperacyjności opartej na protokole WS*. Klient usługi sieci Web lub usługi sieci Web może ogólnie zrozumieć tekstowy kod XML. Jednak przesyłanie dużych bloków danych binarnych jako tekstu jest najmniej wydajną metodą kodowania komunikatów XML.

Przykład

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

Udostępnij za pośrednictwem