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