BinaryMessageEncodingBindingElement Класс

Определение

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

public ref class BinaryMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement
public ref class BinaryMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement, System::ServiceModel::Description::IPolicyExportExtension, System::ServiceModel::Description::IWsdlExportExtension
public sealed class BinaryMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement
public sealed class BinaryMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement, System.ServiceModel.Description.IPolicyExportExtension, System.ServiceModel.Description.IWsdlExportExtension
type BinaryMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement
type BinaryMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement
    interface IWsdlExportExtension
    interface IPolicyExportExtension
Public NotInheritable Class BinaryMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Public NotInheritable Class BinaryMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Implements IPolicyExportExtension, IWsdlExportExtension
Наследование
BinaryMessageEncodingBindingElement
Реализации

Примеры

var be = new BinaryMessageEncodingBindingElement();
be.MaxReadPoolSize = 16;
be.MaxSessionSize = 2048;
be.MaxWritePoolSize = 16;
be.MessageVersion = MessageVersion.Default;
XmlDictionaryReaderQuotas quotas = be.ReaderQuotas;

var binding = new CustomBinding();
var bpCol = new BindingParameterCollection();
var context = new BindingContext(binding, bpCol);
be.BuildChannelFactory<IDuplexChannel>(context);

var binding2 = new CustomBinding();
var bpCol2 = new BindingParameterCollection();
var context2 = new BindingContext(binding2, bpCol2);
be.BuildChannelListener<IDuplexChannel>(context2);

be.CanBuildChannelListener<IDuplexChannel>(context2);
BindingElement bindingElement = be.Clone();
MessageEncoderFactory mef = be.CreateMessageEncoderFactory();
MessageVersion mv = be.GetProperty<MessageVersion>(context);
Dim be As New BinaryMessageEncodingBindingElement()
be.MaxReadPoolSize = 16
be.MaxSessionSize = 2048
be.MaxWritePoolSize = 16
be.MessageVersion = MessageVersion.Default
Dim quotas As XmlDictionaryReaderQuotas = be.ReaderQuotas

Dim binding As New CustomBinding()
Dim bpCol As New BindingParameterCollection()
Dim context As New BindingContext(binding, bpCol)
be.BuildChannelFactory(Of IDuplexChannel)(context)

Dim binding2 As New CustomBinding()
Dim bpCol2 As New BindingParameterCollection()
Dim context2 As New BindingContext(binding2, bpCol2)
be.BuildChannelListener(Of IDuplexChannel)(context2)

be.CanBuildChannelListener(Of IDuplexChannel)(context2)
Dim bindingElement As BindingElement = be.Clone()
Dim mef As MessageEncoderFactory = be.CreateMessageEncoderFactory()
Dim mv As MessageVersion = be.GetProperty(Of MessageVersion)(context)

Комментарии

Кодировка — это процесс преобразования сообщения в последовательность байтов. Декодирование — это обратный процесс. Windows Communication Foundation (WCF) включает три типа кодирования для сообщений SOAP: текстовый, двоичный и механизм оптимизации передачи сообщений (MTOM).

BinaryMessageEncodingBindingElement — это элемент привязки, указывающий, что для кодирования сообщений следует использовать .NET двоичный формат xml. Он имеет параметры для указания кодировки символов и используемой версии SOAP и WS-Addressing. Двоичная кодировка является наиболее эффективной, но наименее совместимой с параметрами кодирования.

Дополнительные сведения об элементе привязки, указывающего сообщения, кодируются с помощью текстового представления XML, см. в разделе TextMessageEncodingBindingElement.

Дополнительные сведения об элементе привязки, указывающего сообщения, кодируются с помощью кодировки сообщений MTOM, см. в разделе MtomMessageEncodingBindingElement.

Чтобы реализовать пользовательский кодировщик сообщений, используйте MessageEncodingBindingElement класс.

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

Имя Описание
BinaryMessageEncodingBindingElement()

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

Свойства

Имя Описание
CompressionFormat

Возвращает или задает формат сжатия для элемента привязки.

MaxReadPoolSize

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

MaxSessionSize

Возвращает или задает максимальный объем памяти, доступный в сеансе для оптимизации процедур передачи.

MaxWritePoolSize

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

MessageVersion

Возвращает или задает сообщение SOAP и WS-Addressing версии, используемые или ожидаемые.

ReaderQuotas

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

Методы

Имя Описание
BuildChannelFactory<TChannel>(BindingContext)

Создает стек фабрики каналов на клиенте, который создает указанный тип канала для указанного контекста.

BuildChannelListener<TChannel>(BindingContext)

Создает прослушиватель каналов в службе, которая принимает указанный тип канала для указанного контекста.

CanBuildChannelFactory<TChannel>(BindingContext)

Возвращает значение, указывающее, может ли элемент привязки создать фабрику каналов для определенного типа канала.

(Унаследовано от BindingElement)
CanBuildChannelListener<TChannel>(BindingContext)

Возвращает значение, указывающее, может ли текущая привязка создать прослушиватель для указанного типа канала и контекста.

Clone()

Создает новый BinaryMessageEncodingBindingElement объект, инициализированный из текущей.

CreateMessageEncoderFactory()

Создает фабрику для кодировщиков двоичных сообщений, использующих версии SOAP и WS-Addressing и кодировку символов, указанную текущим элементом привязки кодирования.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetProperty<T>(BindingContext)

Возвращает типизированный объект, запрошенный при наличии, из соответствующего слоя в стеке элементов привязки.

GetType()

Возвращает Type текущего экземпляра.

(Унаследовано от Object)
MemberwiseClone()

Создает неглубокую копию текущей Object.

(Унаследовано от Object)
ShouldSerializeMessageVersion()

Возвращает значение, следует ли сериализовать версию структуры сообщений SOAP.

ShouldSerializeReaderQuotas()

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

ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

Явные реализации интерфейса

Имя Описание
IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext)

Записывает настраиваемые элементы кодирования двоичных сообщений в созданные метаданные для конечной точки.

IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext)

Записывает настраиваемые элементы кодирования двоичных сообщений в созданный WSDL для контракта.

IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext)

Записывает настраиваемые элементы кодирования двоичных сообщений в созданный WSDL для конечной точки.

Применяется к