MtomMessageEncodingBindingElement Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Элемент привязки, указывающий кодирование и управление версиями для сообщений, использующих механизм оптимизации передачи сообщений (MTOM).
public ref class MtomMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement
public ref class MtomMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement, System::ServiceModel::Description::IPolicyExportExtension, System::ServiceModel::Description::IWsdlExportExtension
public sealed class MtomMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement
public sealed class MtomMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement, System.ServiceModel.Description.IPolicyExportExtension, System.ServiceModel.Description.IWsdlExportExtension
type MtomMessageEncodingBindingElement = class
inherit MessageEncodingBindingElement
type MtomMessageEncodingBindingElement = class
inherit MessageEncodingBindingElement
interface IWsdlExportExtension
interface IPolicyExportExtension
Public NotInheritable Class MtomMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Public NotInheritable Class MtomMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Implements IPolicyExportExtension, IWsdlExportExtension
- Наследование
- Реализации
Комментарии
Кодирование — это процесс преобразования сообщения в последовательность байтов. Декодирование представляет собой обратный процесс. В Windows Communication Foundation (WCF) имеется три типа кодирования для сообщений SOAP: Text, Binary и MTOM.
Класс MtomMessageEncodingBindingElement представляет элемент привязки, в котором указывается кодировка, управление версиями и другие параметры сообщений, для которых применяется механизм оптимизации передачи сообщений (MTOM). MTOM - это эффективный способ передачи двоичных данных в сообщениях WCF. Кодировщик MTOM пытается сохранить баланс между эффективностью и совместимостью. При кодировке MTOM большая часть XML-кода передается в текстовой форме, однако выполняется оптимизация больших блоков двоичных данных путем передачи их в исходном виде, без преобразования их в базовый формат base64.
Дополнительные сведения об элементе привязки, который указывает, что сообщения кодируются с помощью текстового представления XML, см. в разделе TextMessageEncodingBindingElement.
Дополнительные сведения об элементе привязки, который указывает, что сообщения кодируются с помощью двоичного формата .NET для XML, см. в разделе BinaryMessageEncodingBindingElement.
Чтобы реализовать пользовательский кодировщик сообщений, используйте класс MessageEncodingBindingElement.
Конструкторы
MtomMessageEncodingBindingElement() |
Инициализирует новый экземпляр класса MtomMessageEncodingBindingElement. |
MtomMessageEncodingBindingElement(MessageVersion, Encoding) |
Инициализирует новый экземпляр класса MtomMessageEncodingBindingElement с указанной версией сообщения и кодировкой символов. |
Свойства
MaxBufferSize |
Возвращает или задает максимальный размер буфера. |
MaxReadPoolSize |
Возвращает или задает максимальное число средств чтения XML, размещенных в пуле и готовых к обработке входящих сообщений. |
MaxWritePoolSize |
Возвращает или задает максимальное число модулей записи XML, размещенных в пуле и готовых к обработке исходящих сообщений. |
MessageVersion |
Возвращает или задает используемые или ожидаемые версии сообщения SOAP и WS-Addressing. |
ReaderQuotas |
Возвращает или задает ограничения по сложности сообщений XML, которые могут обрабатываться конечными точками, настроенными с этим элементом привязки. |
WriteEncoding |
Возвращает или задает кодировку, используемую для форматирования символов в текстовом сообщении. |
Методы
BuildChannelFactory<TChannel>(BindingContext) |
Выполняет построение стека фабрики каналов на клиенте, создающей каналы заданного типа для заданного контекста. |
BuildChannelListener<TChannel>(BindingContext) |
Выполняет построение стека прослушивателя каналов на клиенте, принимающего заданный тип канала для заданного контекста. |
BuildChannelListener<TChannel>(BindingContext) |
Инициализирует прослушиватель каналов для приема каналов заданного типа из контекста привязки. (Унаследовано от BindingElement) |
CanBuildChannelFactory<TChannel>(BindingContext) |
Возвращает значение, указывающее, может ли текущая привязка выполнить построение фабрики заданного типа каналов и контекста. |
CanBuildChannelListener<TChannel>(BindingContext) |
Возвращает значение, указывающее, может ли текущая привязка выполнить построение прослушивателя заданного типа каналов и контекста. |
CanBuildChannelListener<TChannel>(BindingContext) |
Возвращает значение, показывающее, может ли элемент привязки создать прослушиватель для заданного типа канала. (Унаследовано от BindingElement) |
Clone() |
Создает новый объект MtomMessageEncodingBindingElement, инициализированный из текущего объекта. |
CreateMessageEncoderFactory() |
Создает фабрику кодировщиков сообщений, кодирующую сообщения MTOM. |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetProperty<T>(BindingContext) |
Возвращает запрашиваемый типизированный объект, если он имеется, из соответствующего уровня стека элементов привязки. |
GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
ShouldSerializeMessageVersion() |
Возвращает значение, которое указывает, должна ли версия структуры сообщения SOAP быть сериализована. |
ShouldSerializeReaderQuotas() |
Возвращает значение, которое указывает, должны ли ограничения, заданные для структуры сообщения SOAP, быть сериализованы. |
ShouldSerializeWriteEncoding() |
Возвращает значение, указывающее должен ли объект Encoding, используемый для форматирования символов в сообщении, быть сериализован. |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
Явные реализации интерфейса
IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext) |
Добавляет утверждение политики в WSDL-код при его создании, указывающее, что используется кодировка MTOM. |
IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext) |
Изменяет контракт WSDL, добавляя информацию по механизму оптимизации передачи сообщений (MTOM). |
IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext) |
Добавляет версию сообщения SOAP в WSDL-код. |