WebMessageEncodingBindingElement Класс

Определение

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

Наследование

Object

BindingElement

MessageEncodingBindingElement

WebMessageEncodingBindingElement

Реализации

IWsdlExportExtension

Комментарии

Кодировка — это процесс преобразования сообщения в последовательность байтов. Декодирование — это обратный процесс. Для этих процессов требуется спецификация кодировки символов. Эти WebMessageEncodingBindingElement действия выполняются путем делегирования в ряд внутренних кодировщиков для обработки кодировки XML и JSON обычного текста и необработанных двоичных данных. Это делегирование выполняется составным кодировщиком сообщений.

Этот элемент привязки и его составной кодировщик используются для управления кодировкой в сценариях, которые не используют обмен сообщениями SOAP, используемыми в этом кодировщике WebHttpBinding. К этим сценариям относятся "Обычный старый XML" (POX), передача репрезентативного состояния (REST), очень простая синдикация (RSS) и синдикация Atom, а также асинхронная javaScript и XML (AJAX). Кодировщик составных сообщений не поддерживает SOAP или WS-Адресацию, поэтому MessageVersion всегда возвращается None.

Элемент привязки можно настроить с кодировкой символов записи во время построения с помощью конструктора WebMessageEncodingBindingElement(Encoding) . Значение Encoding указывает поведение записи для случаев JSON и Textual XML. При чтении понятно любое допустимое кодирование сообщений и кодировка текста.

Этот конструктор задает значения по умолчанию для максимального количества читателей и записи, выделенных пулам, и которые соответственно доступны для обработки входящих и исходящих сообщений без выделения новых средств чтения или записи. Свойства MaxReadPoolSize и MaxWritePoolSize также можно использовать для задания максимального количества читателей и записи, которые будут выделены соответственно. По умолчанию выделяется 64 читателей и 16 писателей.

Ограничения сложности по умолчанию также задаются этим конструктором XmlDictionaryReaderQuotas в связанном с этим кодировке ReaderQuotas свойством для защиты от атак типа "отказ в обслуживании" (DOS), которые пытаются использовать сложность сообщения для привязки ресурсов обработки конечных точек.

У WebMessageEncodingBindingElement него есть CreateMessageEncoderFactory метод, который создает фабрику кодировщика сообщений, которая создает декодеры JSON, XML или необработанные сообщения и кодировщики в зависимости от указанного типа контента.

Он WebMessageEncodingBindingElement также предоставляет методы для создания фабрик и прослушивателей для каналов, через которые поток HTTP-запросов.

Составной кодировщик и связанные с ним классы и компоненты конфигурации доступны в частичном доверии, и это не требует специальных разрешений.