BinaryMessageEncodingElement Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет кодировщик сообщений, кодирующий сообщения Windows Communication Foundation (WCF) в двоичном формате в сети. Этот класс не наследуется.
public ref class BinaryMessageEncodingElement sealed : System::ServiceModel::Configuration::BindingElementExtensionElement
public sealed class BinaryMessageEncodingElement : System.ServiceModel.Configuration.BindingElementExtensionElement
type BinaryMessageEncodingElement = class
inherit BindingElementExtensionElement
Public NotInheritable Class BinaryMessageEncodingElement
Inherits BindingElementExtensionElement
- Наследование
-
BinaryMessageEncodingElement
- Наследование
-
BinaryMessageEncodingElement
Комментарии
Кодирование - это процесс преобразования набора символов Юникода в последовательность байтов.
Класс BinaryMessageEncodingElement представляет раздел конфигурации, в котором указываются параметры кодировки и управления версиями для XML-сообщений в двоичном формате. Кодировщик двоичных сообщений кодирует сообщения WCF в двоичном формате по сети. Результатом этой кодировки является очень быстрая передача сообщений, однако вследствие этого теряются возможности взаимодействия, основанные на стандартах WS-*.
Класс MtomMessageEncodingElement представляет раздел конфигурации, в котором указываются параметры кодировки и управления версиями для сообщений, для которых применяется подсистема оптимизации передачи сообщений MTOM. MTOM - это эффективный способ передачи двоичных данных в сообщениях WCF. Кодировщик MTOM пытается обеспечить баланс между эффективностью и взаимодействием. Кодирование MTOM передает большую часть XML-данных в текстовой форме, но оптимизирует большие блоки двоичных данных путем передачи их в исходном виде, без преобразования в текст.
Класс TextMessageEncodingElement представляет раздел конфигурации, в котором указывается кодировщик текста, используемый для создания текстовых сообщений, передаваемых по проводным линиям связи. Сообщения, созданные этим кодировщиком, подходят для взаимодействия на базе WS-*. Веб-служба или клиент веб-службы в общем могут понимать XML в текстовом виде. Однако передача больших блоков двоичных данных в виде текста является наименее эффективным методом для кодировки сообщений XML.
Конструкторы
| BinaryMessageEncodingElement() |
Инициализирует новый экземпляр класса BinaryMessageEncodingElement. |
Свойства
| BindingElementType |
Возвращает тип этого элемента привязки. |
| CompressionFormat |
Получает или задает формат сжатия, используемый в элементе кодирования двоичных сообщений. |
| ConfigurationElementName |
Возвращает имя этого элемента конфигурации. (Унаследовано от ServiceModelExtensionElement) |
| CurrentConfiguration |
Возвращает ссылку на экземпляр Configuration верхнего уровня, представляющий иерархию конфигурации, к которой относится текущий экземпляр ConfigurationElement. (Унаследовано от ConfigurationElement) |
| ElementInformation |
Возвращает объект ElementInformation, содержащий неизменяемую информацию и функциональность объекта ConfigurationElement. (Унаследовано от ConfigurationElement) |
| ElementProperty |
Возвращает объект ConfigurationElementProperty, представляющий сам объект ConfigurationElement. (Унаследовано от ConfigurationElement) |
| EvaluationContext |
Возвращает объект ContextInformation для объекта ConfigurationElement. (Унаследовано от ConfigurationElement) |
| HasContext |
Возвращает значение, указывающее, имеет ли свойство CurrentConfiguration значение |
| Item[ConfigurationProperty] |
Возвращает или задает свойство или атрибут данного элемента конфигурации. (Унаследовано от ConfigurationElement) |
| Item[String] |
Получает или задает свойство, атрибут или дочерний элемент данного элемента конфигурации. (Унаследовано от ConfigurationElement) |
| LockAllAttributesExcept |
Возвращает коллекцию заблокированных атрибутов. (Унаследовано от ConfigurationElement) |
| LockAllElementsExcept |
Возвращает коллекцию заблокированных элементов. (Унаследовано от ConfigurationElement) |
| LockAttributes |
Возвращает коллекцию заблокированных атрибутов. (Унаследовано от ConfigurationElement) |
| LockElements |
Возвращает коллекцию заблокированных элементов. (Унаследовано от ConfigurationElement) |
| LockItem |
Возвращает или задает значение, указывающее, заблокирован ли элемент. (Унаследовано от ConfigurationElement) |
| MaxReadPoolSize |
Возвращает или задает значение, указывающее максимальное количество сообщений, которые можно считать одновременно без выделения памяти для дополнительных модулей чтения. |
| MaxSessionSize |
Возвращает или задает значение, указывающее максимальный размер буфера, используемого для кодирования (в байтах). |
| MaxWritePoolSize |
Возвращает или задает значение, указывающее максимальное количество сообщений, которые можно отправить одновременно без выделения памяти для дополнительных модулей записи. |
| Properties |
Возвращает коллекцию свойств. (Унаследовано от ConfigurationElement) |
| ReaderQuotas |
Возвращает или задает ограничения по сложности сообщений SOAP, которые могут обрабатываться конечными точками, настроенными с этой привязкой. |
Методы
| 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() в |
| 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) |