WebMessageEncodingBindingElement Klass

Definition

public ref class WebMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement, System::ServiceModel::Description::IWsdlExportExtension

public sealed class WebMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement, System.ServiceModel.Description.IWsdlExportExtension

type WebMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement
    interface IWsdlExportExtension

Public NotInheritable Class WebMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Implements IWsdlExportExtension

Arv

Object

BindingElement

MessageEncodingBindingElement

WebMessageEncodingBindingElement

Implementeringar

IWsdlExportExtension

Kommentarer

Kodning är processen att omvandla ett meddelande till en sekvens med byte. Avkodning är den omvända processen. Dessa processer kräver specifikation av en teckenkodning. Fungerar WebMessageEncodingBindingElement genom att delegera till en serie inre kodare för att hantera oformaterade XML- och JSON-kodningar och "råa" binära data. Den här delegeringen görs av en sammansatt meddelandekodare.

Det här bindningselementet och dess sammansatta kodare används för att styra kodningen i scenarier som inte använder SOAP-meddelanden som används av WebHttpBinding. Dessa scenarier inkluderar "Plain Old XML" (POX), Representational State Transfer (REST), Really Simple Syndication (RSS) och Atom syndication samt Asynkron JavaScript och XML (AJAX). Den sammansatta meddelandekodaren stöder inte SOAP eller WS-Addressing och returnerar MessageVersiondärför None alltid .

Bindningselementet kan konfigureras med en skrivteckenkodning vid byggtiden med konstruktorn WebMessageEncodingBindingElement(Encoding) . Värdet Encoding anger beteendet vid skrivning för JSON- och Text-XML-fallen. Vid läsning förstås alla giltiga meddelandekodningar och textkodning.

Den här konstruktorn anger standardvärden på det maximala antalet läsare och skrivare som har allokerats till pooler och som är tillgängliga för att bearbeta inkommande och utgående meddelanden utan att tilldela nya läsare eller skrivare. Egenskaperna MaxReadPoolSize och MaxWritePoolSize kan också användas för att ange det maximala antalet läsare respektive skrivare som ska allokeras. Som standard allokeras 64 läsare och 16 skrivare.

Standardkomplexitetsbegränsningar anges också av den här konstruktorn för den som är associerad med den XmlDictionaryReaderQuotasReaderQuotas här kodningen av egenskapen för att skydda mot en klass av DOS-attacker (Denial of Service) som försöker använda meddelandekomplexitet för att binda slutpunktsbearbetningsresurser.

WebMessageEncodingBindingElement Har en CreateMessageEncoderFactory metod som skapar en meddelandekodarfabrik som producerar JSON-, XML- eller Raw-meddelandedekodare och kodare efter behov beroende på vilken innehållstyp som angetts.

Innehåller WebMessageEncodingBindingElement också metoder för att skapa fabriker och lyssnare för de kanaler genom vilka HTTP-begäranden flödar.

Den sammansatta kodaren och dess associerade klasser och konfigurationskomponenter kan användas i partiellt förtroende och den här användningen kräver inga särskilda behörigheter.