Dela via


<textMessageEncoding>

Anger teckenkodning och versionshantering av meddelanden som används för textbaserade XML-meddelanden.

<Konfiguration>
  <system.serviceModel>
    <Bindningar>
      <customBinding>
        <Bindande>
          <textMessageEncoding>

Syntax

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

Attribut och element

I följande avsnitt beskrivs attribut, underordnade element och överordnade element.

Attribut

Attribut Beskrivning
maxReadPoolSize Ett heltal som anger hur många meddelanden som kan läsas samtidigt utan att tilldela nya läsare. Större poolstorlekar gör systemet mer tolerant mot aktivitetstoppar på bekostnad av en större arbetsuppsättning. Standardvärdet är 64.
maxWritePoolSize Ett heltal som anger hur många meddelanden som kan skickas samtidigt utan att tilldela nya skrivare. Större poolstorlekar gör systemet mer tolerant mot aktivitetstoppar på bekostnad av en större arbetsuppsättning. Standardvärdet är 16.
messageVersion Anger SOAP-versionen av de meddelanden som skickas med bindningen. Giltiga värden är

- Soap11Addressing10
- Soap12Addressing10
- Soap11
- Soap12

Standardvärdet är Soap12Addressing10. Det här attributet är av typen MessageVersion.
writeEncoding Anger den teckenuppsättningskodning som ska användas för att generera meddelanden på bindningen. Giltiga värden är

- UnicodeFffeTextEncoding: Unicode BigEndian-kodning
- Utf16TextEncoding: Unicode-kodning
- Utf8TextEncoding: 8-bitars kodning

Standardvärdet är Utf8TextEncoding. Det här attributet är av typen Encoding.

Underordnade element

Element Beskrivning
<readerQuotas> Definierar begränsningarna för komplexiteten i SOAP-meddelanden som kan bearbetas av slutpunkter som konfigurerats med den här bindningen. Det här elementet är av typen XmlDictionaryReaderQuotasElement.

Överordnade element

Element Beskrivning
<Bindande> Definierar alla bindningsfunktioner för den anpassade bindningen.

Kommentarer

Kodning är processen att omvandla ett meddelande till en sekvens med byte. Avkodning är den omvända processen. Windows Communication Foundation (WCF) innehåller tre typer av kodning för SOAP-meddelanden: mekanismen för text-, binär- och meddelandeöverföringsoptimering (MTOM).

Den textkodning som representeras av elementet textMessageEncoding är den mest samverkande, men den minst effektiva kodaren för XML-meddelanden. Textkodaren skapar textbaserade meddelanden på tråden. Meddelanden som skapas av den här kodaren är lämpliga för WS-*-baserad interop. Webbtjänst- eller webbtjänstklienten kan vanligtvis förstå text-XML. Att överföra stora block med binära data som text är dock den minst effektiva metoden för kodning av XML-meddelanden.

Exempel

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

Se även