Edit

Share via

<binaryMessageEncoding>

Defines a binary message encoder that encodes Windows Communication Foundation (WCF) messages in binary on the wire.

<configuration>
  <system.serviceModel>
    <bindings>
      <customBinding>
        <binding>
          <binaryMessageEncoding>

Syntax

<binaryMessageEncoding maxReadPoolSize="Integer"
                       maxSessionSize="Integer"
                       maxWritePoolSize="Integer"
                       messageVersion="Soap11Addressing10/Soap12Addressing10" />

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute Description
maxReadPoolSize An integer that defines how many messages can be read simultaneously without allocating new readers. Larger pool sizes make the system more tolerant to activity spikes at the cost of a larger working set. The default is 64.
maxSessionSize A positive integer that sets the size, in bytes, of the buffer used for encoding. A larger buffer increases encoding speed at the expense of the size of the working set. The default is 2048.
maxWritePoolSize An integer that defines how many messages can be sent simultaneously without allocating new writers. Larger pool sizes make the system more tolerant to activity spikes at the cost of a larger working set. The default is 16.
messageVersion Specifies the SOAP message and WS-Addressing versions that are used or expected.

Child Elements

Element Description
<readerQuotas> Defines the constraints on the complexity of SOAP messages that can be processed by endpoints configured with this binding. This element is of type XmlDictionaryReaderQuotasElement.

Parent Elements

Element Description
<binding> Defines all binding capabilities of the custom binding.

Remarks

Encoding is the process of transforming a message into a sequence of bytes. Decoding is the reverse process. Windows Communication Foundation (WCF) includes three types of encoding for SOAP messages: Text, Binary and Message Transmission Optimization Mechanism (MTOM).

The binaryMessageEncoding element specifies the .NET Binary Format for XML and has options to specify the character encoding and the SOAP and WS-Addressing version to be used. The binary message encoder encodes Windows Communication Foundation (WCF) messages in binary on the wire. While this encoding results in very fast transmission of messages, interoperability based on the WS-* standards is lost.

Example

<binaryMessageEncoding maxReadPoolSize="211"
                       maxWritePoolSize="2132"
                       maxSessionSize="3141" />

See also

  • Last updated on