TextMessageEncodingBindingElement Класс

Определение

Пространство имен:

System.ServiceModel.Channels

Сборка:

System.ServiceModel.dll

Элемент привязки, указывающий кодировку символов и управление версиями сообщений, используемых для текстовых сообщений SOAP.

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, System.ServiceModel.Description.IPolicyExportExtension, System.ServiceModel.Description.IWsdlExportExtension

type TextMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement
    interface IWsdlExportExtension
    interface IPolicyExportExtension

Public NotInheritable Class TextMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Implements IPolicyExportExtension, IWsdlExportExtension

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

Object

BindingElement

MessageEncodingBindingElement

TextMessageEncodingBindingElement

Реализации

IPolicyExportExtension IWsdlExportExtension

Комментарии

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