TextMessageEncodingElement Класс

Определение

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

System.ServiceModel.Configuration

Сборка:

System.ServiceModel.dll

Представляет элемент конфигурации, в котором указываются параметры кодировки и управления версиями для XML-сообщений в текстовом формате. Этот класс не наследуется.

public ref class TextMessageEncodingElement sealed : System::ServiceModel::Configuration::BindingElementExtensionElement

public sealed class TextMessageEncodingElement : System.ServiceModel.Configuration.BindingElementExtensionElement

type TextMessageEncodingElement = class
    inherit BindingElementExtensionElement

Public NotInheritable Class TextMessageEncodingElement
Inherits BindingElementExtensionElement

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

Object

ConfigurationElement

ServiceModelConfigurationElement

ServiceModelExtensionElement

BindingElementExtensionElement

TextMessageEncodingElement

Комментарии

Кодировщик текста создает текстовые сообщения в сети. Сообщения, созданные этим кодировщиком, подходят для взаимодействия на базе WS-*.

Кодирование - это процесс преобразования набора символов Юникода в последовательность байтов.

Кодировщик текста, указанный в данном разделе конфигурации, создает текстовые сообщения в сети. Сообщения, созданные этим кодировщиком, подходят для взаимодействия на базе WS-*. Веб-служба или клиент веб-службы в общем могут понимать XML в текстовом виде. Однако передача больших блоков двоичных данных в виде текста является наименее эффективным методом для кодировки сообщений XML.

Класс BinaryMessageEncodingElement представляет элемент конфигурации, в котором указываются параметры кодировки и управления версиями для XML-сообщений в двоичном формате. Этот вариант кодирования является наиболее эффективными, но обладает наименьшими возможностями взаимодействия.

Класс MtomMessageEncodingElement представляет элемент конфигурации, в котором указываются параметры кодировки и управления версиями для сообщений, для которых применяется подсистема оптимизации передачи сообщений MTOM. MTOM — это эффективная технология для передачи двоичных данных в сообщениях Windows Communication Foundation (WCF). Кодировщик MTOM предпринимает попытку соблюсти баланс между эффективностью и взаимодействием. Кодирование MTOM передает большую часть XML-данных в текстовой форме, но оптимизирует большие блоки двоичных данных путем передачи их в исходном виде, без преобразования в текст.

Конструкторы

TextMessageEncodingElement()

Инициализирует новый экземпляр класса TextMessageEncodingElement.

Свойства

BindingElementType	Возвращает тип Type этого элемента конфигурации.
ConfigurationElementName	Возвращает имя этого элемента конфигурации. (Унаследовано от ServiceModelExtensionElement)
CurrentConfiguration	Возвращает ссылку на экземпляр Configuration верхнего уровня, представляющий иерархию конфигурации, к которой относится текущий экземпляр ConfigurationElement. (Унаследовано от ConfigurationElement)
ElementInformation	Возвращает объект ElementInformation, содержащий неизменяемую информацию и функциональность объекта ConfigurationElement. (Унаследовано от ConfigurationElement)
ElementProperty	Возвращает объект ConfigurationElementProperty, представляющий сам объект ConfigurationElement. (Унаследовано от ConfigurationElement)
EvaluationContext	Возвращает объект ContextInformation для объекта ConfigurationElement. (Унаследовано от ConfigurationElement)
HasContext	Возвращает значение, указывающее, имеет ли свойство CurrentConfiguration значение null. (Унаследовано от ConfigurationElement)
Item[ConfigurationProperty]	Возвращает или задает свойство или атрибут данного элемента конфигурации. (Унаследовано от ConfigurationElement)
Item[String]	Получает или задает свойство, атрибут или дочерний элемент данного элемента конфигурации. (Унаследовано от ConfigurationElement)
LockAllAttributesExcept	Возвращает коллекцию заблокированных атрибутов. (Унаследовано от ConfigurationElement)
LockAllElementsExcept	Возвращает коллекцию заблокированных элементов. (Унаследовано от ConfigurationElement)
LockAttributes	Возвращает коллекцию заблокированных атрибутов. (Унаследовано от ConfigurationElement)
LockElements	Возвращает коллекцию заблокированных элементов. (Унаследовано от ConfigurationElement)
LockItem	Возвращает или задает значение, указывающее, заблокирован ли элемент. (Унаследовано от ConfigurationElement)
MaxReadPoolSize	Возвращает или задает значение, указывающее максимальное количество сообщений, которые можно считать одновременно без выделения памяти для дополнительных модулей чтения.
MaxWritePoolSize	Возвращает или задает значение, указывающее максимальное количество сообщений, которые можно отправить одновременно без выделения памяти для дополнительных модулей записи.
MessageVersion	Возвращает или задает версии SOAP и WS-Addressing, используемые для форматирования текстового сообщения, отправляемого с помощью этой привязки.
Properties	Возвращает коллекцию свойств. (Унаследовано от ConfigurationElement)
ReaderQuotas	Возвращает или задает ограничения по сложности сообщений SOAP, которые могут обрабатываться конечными точками, настроенными с этой привязкой.
WriteEncoding	Возвращает или задает кодировку, используемую при создании сообщений для привязки.

Методы

ApplyConfiguration(BindingElement)	Применяет содержимое указанного элемента привязки к данному разделу конфигурации привязки.
CopyFrom(ServiceModelExtensionElement)	Копирует содержимое указанного раздела конфигурации в данный элемент.
CreateBindingElement()	При переопределении в производном классе возвращает настраиваемый объект элемента привязки. (Унаследовано от BindingElementExtensionElement)
DeserializeElement(XmlReader, Boolean)	Считывает XML из файла конфигурации. (Унаследовано от ConfigurationElement)
Equals(Object)	Сравнивает текущий экземпляр ConfigurationElement с указанным объектом. (Унаследовано от ConfigurationElement)
GetHashCode()	Получает уникальное значение, представляющее текущий экземпляр ConfigurationElement. (Унаследовано от ConfigurationElement)
GetTransformedAssemblyString(String)	Возвращает преобразованную версию указанного имени сборки. (Унаследовано от ConfigurationElement)
GetTransformedTypeString(String)	Возвращает преобразованную версию указанного имени типа. (Унаследовано от ConfigurationElement)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
Init()	Задает объект ConfigurationElement в исходное состояние. (Унаследовано от ConfigurationElement)
InitializeDefault()	Используется для инициализации набора значений по умолчанию для объекта ConfigurationElement. (Унаследовано от ConfigurationElement)
InitializeFrom(BindingElement)	Инициализирует этот раздел конфигурации привязки с помощью содержимого заданного элемента привязки. (Унаследовано от BindingElementExtensionElement)
IsModified()	Возвращает значение, определяющее, был ли изменен данный элемент конфигурации. (Унаследовано от ServiceModelExtensionElement)
IsReadOnly()	Получает значение, показывающее, является ли объект ConfigurationElement доступным только для чтения. (Унаследовано от ConfigurationElement)
ListErrors(IList)	Добавляет ошибку "недействительное свойство" в данном объекте ConfigurationElement и всех его дочерних элементах к переданному списку. (Унаследовано от ConfigurationElement)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
OnDeserializeUnrecognizedAttribute(String, String)	Возвращает значение, указывающее, встретился ли неизвестный атрибут при десериализации. (Унаследовано от ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Возвращает значение, указывающее, встретился ли неизвестный элемент при десериализации. (Унаследовано от ConfigurationElement)
OnRequiredPropertyNotFound(String)	Выдает исключение, если требуемое свойство не найдено. (Унаследовано от ConfigurationElement)
PostDeserialize()	Вызывается после десериализации. (Унаследовано от ConfigurationElement)
PreSerialize(XmlWriter)	Вызывается до сериализации. (Унаследовано от ConfigurationElement)
Reset(ConfigurationElement)	Восстанавливает внутреннее состояние данного объекта элемента конфигурации, включая блокировки и коллекции свойств. (Унаследовано от ServiceModelExtensionElement)
ResetModified()	Переустанавливает значение метода IsModified() в false при реализации в производном классе. (Унаследовано от ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Записывает содержимое данного элемента конфигурации в файл конфигурации. (Унаследовано от ServiceModelExtensionElement)
SerializeToXmlElement(XmlWriter, String)	Записывает внешние теги данного элемента конфигурации в файл конфигурации при реализации в производном классе. (Унаследовано от ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Задает для свойства указанное значение. (Унаследовано от ConfigurationElement)
SetPropertyValueIfNotDefaultValue<T>(String, T)	Задает значение свойства для элемента конфигурации, если значение не является значением по умолчанию. (Унаследовано от ServiceModelConfigurationElement)
SetReadOnly()	Задает свойство IsReadOnly() для объекта ConfigurationElement и всех подчиненных элементов. (Унаследовано от ConfigurationElement)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Изменяет объект ConfigurationElement для удаления всех значений, которые не должны сохраняться. (Унаследовано от ConfigurationElement)

См. также раздел

• TextMessageEncodingBindingElement
• TextMessageEncoding в конфигурации