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: текстовый, двоичный и механизм оптимизации передачи сообщений (MTOM).
Представляет MtomMessageEncodingBindingElement элемент привязки, указывающий кодировку символов и управление версиями сообщений и другие параметры, используемые для сообщений с помощью кодировки MTOM. MTOM — это эффективная технология передачи двоичных данных в сообщениях WCF. Кодировщик MTOM пытается создать баланс между эффективностью и взаимодействием. Кодировка MTOM передает большинство XML в текстовой форме, но оптимизирует большие блоки двоичных данных путем передачи их as-isбез преобразования в формат в кодировке 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) |
Создает стек прослушивателя каналов на клиенте, который принимает указанный тип канала для указанного контекста. |
| CanBuildChannelFactory<TChannel>(BindingContext) |
Возвращает значение, указывающее, может ли текущая привязка создать фабрику для указанного типа канала и контекста. |
| CanBuildChannelListener<TChannel>(BindingContext) |
Возвращает значение, указывающее, может ли текущая привязка создать прослушиватель для указанного типа канала и контекста. |
| 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. |