Sdílet prostřednictvím

<webMessageEncoding>

Umožňuje čtení a zápis binárního obsahu ve formátu PROSTÉho textu, javascriptového zápisu objektů JSON (JavaScript Object Notation) a "nezpracovaného" binárního obsahu při použití ve vazbě WCF (Windows Communication Foundation).

<konfigurace>
   <System.servicemodel>
     <na něčí žádosti>
       <customBinding>
         <závazný>
           <webMessageEncoding>

Syntaxe

<webMessageEncoding maxReadPoolSize="Integer"
                    maxWritePoolSize="Integer"
                    writeEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding" />

Atributy a prvky

Následující části popisují atributy, podřízené prvky a nadřazené prvky.

Attributes

Vlastnost Description
maxReadPoolSize Množství zpráv, které lze číst současně bez přidělení nových čtenářů. Větší velikosti fondů činí systém odolnější vůči špičkám aktivity za cenu větší pracovní sady. Výchozí hodnota je 64 čtenářů pro každý vnitřní kodér (text, JSON a "nezpracovaný").

Zvýšení tohoto počtu zvyšuje spotřebu paměti, ale připraví kodér na řešení náhlého nárůstu příchozích zpráv, protože může používat čtenáře z fondu, který už je vytvořený, místo vytváření nových zpráv.
maxWritePoolSize Množství zpráv, které lze odeslat současně bez přidělování nových zapisovačů. Větší velikosti fondů činí systém odolnější vůči špičkám aktivity za cenu větší pracovní sady. Výchozí hodnota je 16 zapisovačů pro každý vnitřní kodér (text, JSON a "raw").

Zvýšení tohoto počtu zvyšuje spotřebu paměti, ale připraví kodér na řešení náhlého nárůstu odchozích zpráv, protože může používat zapisovače z fondu, které jsou již vytvořeny, místo vytváření nových zpráv.
writeEncoding Určuje kódování znakové sady, které se má použít pro generování zpráv ve vazbě. Platné hodnoty jsou:

– UnicodeFffeTextEncoding: Kódování Unicode Big Endian.
- Utf16TextEncoding: Kódování Unicode.
- Utf8TextEncoding: 8bitové kódování.

Výchozí hodnota je Utf8TextEncoding. Tento atribut je typu Encoding.

Podřízené prvky

prvek Description
<readerQuotas> Definuje omezení složitosti zpráv SOAP, které lze zpracovat koncovými body nakonfigurovanými touto vazbou. Tento prvek je typu XmlDictionaryReaderQuotasElement.

Nadřazené prvky

prvek Description
<závazný> Definuje všechny možnosti vazby vlastní vazby.

Poznámky

Kódování je proces transformace zprávy na posloupnost bajtů. Dekódování je reverzní proces. Tyto procesy vyžadují specifikaci kódování znaků.

Tento webMessageEncoding element funguje delegováním na řadu vnitřních kodérů pro zpracování kódování XML a JSON ve formátu prostého textu a "nezpracovanými" binárními daty. Toto delegování provádí složený kodér zpráv.

Tento element vazby a jeho složený kodér slouží k řízení kódování ve scénářích, které nepoužívají zasílání zpráv SOAP používané elementem webHttpBinding . Mezi tyto scénáře patří "Plain Old XML" (POX), Representational State Transfer (REST), Really Simple Syndication (RSS) a Atom syndikace a Asynchronní JavaScript a XML (AJAX). Složený kodér zpráv nepodporuje adresování SOAP ani WS.

Element vazby lze nakonfigurovat pomocí kódování znaku zápisu pomocí atributu writeEncoding . Zadaná Encoding hodnota určuje chování při zápisu pro případy JSON a Textal XML. Při čtení se rozumí veškeré platné kódování zpráv a kódování textu.

maxReadPoolSize lze maxWritePoolSize také použít k nastavení maximálního počtu čtenářů a autorů, které mají být přiděleny. Ve výchozím nastavení je přiděleno 64 čtenářů a 16 autorů.

Výchozí omezení složitosti jsou také nastavena pomocí elementu <readerQuotas> k ochraně před třídou útoků DOS (Denial of Service), které se pokoušejí použít složitost zpráv ke svázání prostředků zpracování koncových bodů.

Example

<webMessageEncoding maxReadPoolSize="256"
                    maxWritePoolSize="128"
                    messageVersion="None"
                    textEncoding="utf-8" />

Viz také

  • Last updated on