Udostępnij przez

<textMessageEncoding>

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

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

Attributes

Attribute Description
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

- 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

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).

Kodowanie tekstu reprezentowane przez textMessageEncoding element jest najbardziej współdziałalne, ale najmniej wydajny koder dla komunikatów XML. Koder tekstowy tworzy wiadomości tekstowe na przewodach. Komunikaty generowane przez ten koder są odpowiednie dla międzyoperacyjności opartej na usłudze WS*. Usługa sieci Web lub klient usługi sieci Web zazwyczaj rozumie tekstowy kod XML. Jednak przesyłanie dużych bloków danych binarnych jako tekstu jest najmniej wydajną metodą kodowania komunikatów XML.

Example

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

Zobacz także

  • Last updated on