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-код. |