MtomMessageEncodingBindingElement Class

 

The binding element that specifies the encoding and versioning used for Message Transmission Optimization Mechanism (MTOM) messages.

Namespace:   System.ServiceModel.Channels
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

System.Object
  System.ServiceModel.Channels.BindingElement
    System.ServiceModel.Channels.MessageEncodingBindingElement
      System.ServiceModel.Channels.MtomMessageEncodingBindingElement

public sealed class MtomMessageEncodingBindingElement : MessageEncodingBindingElement, 
	IWsdlExportExtension, IPolicyExportExtension

NameDescription
System_CAPS_pubmethodMtomMessageEncodingBindingElement()

Initializes a new instance of the MtomMessageEncodingBindingElement class.

System_CAPS_pubmethodMtomMessageEncodingBindingElement(MessageVersion, Encoding)

Initializes a new instance of the MtomMessageEncodingBindingElement class with a specified message version and character encoding.

NameDescription
System_CAPS_pubpropertyMaxBufferSize

Gets or sets the maximum buffer size.

System_CAPS_pubpropertyMaxReadPoolSize

Gets or sets the maximum number of XML readers that is allocated to a pool and is ready for use to process incoming messages.

System_CAPS_pubpropertyMaxWritePoolSize

Gets or sets the maximum number of XML writers that is allocated to a pool and are ready for use to process outgoing messages.

System_CAPS_pubpropertyMessageVersion

Gets or sets the SOAP message and WS-Addressing versions that are used or expected.(Overrides MessageEncodingBindingElement.MessageVersion.)

System_CAPS_pubpropertyReaderQuotas

Gets or sets constraints on the complexity of XML messages that can be processed by endpoints configured with this binding element.

System_CAPS_pubpropertyWriteEncoding

Gets or sets the encoding that is used to format the characters in the text message.

NameDescription
System_CAPS_pubmethodBuildChannelFactory<TChannel>(BindingContext)

Builds the channel factory stack on the client that creates a specified type of channel for a specified context.(Overrides BindingElement.BuildChannelFactory<TChannel>(BindingContext).)

System_CAPS_pubmethodBuildChannelListener<TChannel>(BindingContext)

Builds the channel listener stack on the client that accepts a specified type of channel for a specified context.(Overrides BindingElement.BuildChannelListener<TChannel>(BindingContext).)

System_CAPS_pubmethodCanBuildChannelFactory<TChannel>(BindingContext)

Returns a value that indicates whether the current binding can build a factory for a specified type of channel and context.(Overrides BindingElement.CanBuildChannelFactory<TChannel>(BindingContext).)

System_CAPS_pubmethodCanBuildChannelListener<TChannel>(BindingContext)

Returns a value that indicates whether the current binding can build a listener for a specified type of channel and context.(Overrides BindingElement.CanBuildChannelListener<TChannel>(BindingContext).)

System_CAPS_pubmethodClone()

Creates a new MtomMessageEncodingBindingElement object initialized from the current one.(Overrides BindingElement.Clone().)

System_CAPS_pubmethodCreateMessageEncoderFactory()

Creates a message encoder factory that encodes MTOM messages.(Overrides MessageEncodingBindingElement.CreateMessageEncoderFactory().)

System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetProperty<T>(BindingContext)

Returns a typed object requested, if present, from the appropriate layer in the binding element stack.(Overrides MessageEncodingBindingElement.GetProperty<T>(BindingContext).)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_pubmethodShouldSerializeMessageVersion()

Returns whether the SOAP message structure version should be serialized.

System_CAPS_pubmethodShouldSerializeReaderQuotas()

Returns whether the constraints placed on the complexity of SOAP message structure should be serialized.

System_CAPS_pubmethodShouldSerializeWriteEncoding()

Returns whether the Encoding that is used to format the message characters should be serialized.

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

NameDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodIPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext)

Inserts a policy assertion into the WSDL, when it is generated, which indicates that an MTOM encoding is being used.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext)

Modifies the WSDL contract for MTOM-specific information.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext)

Puts the SOAP message version into the WSDL.

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 MtomMessageEncodingBindingElement represents the binding element that specifies the character encoding and message versioning and other settings used for messages using a Message Transmission Optimization Mechanism (MTOM) encoding. MTOM is an efficient technology for transmitting binary data in WCF messages. The MTOM encoder attempts to create a balance between efficiency and interoperability. The MTOM encoding transmits most XML in textual form, but optimizes large blocks of binary data by transmitting them as-is, without conversion to their base64 encoded format.

For more information about the binding element that specifies that messages are encoded using a textual representation of XML, see TextMessageEncodingBindingElement.

For more information about the binding element that specifies messages are encoded using the .NET Binary Format for XML, see BinaryMessageEncodingBindingElement.

To implement a custom message encoder, use the MessageEncodingBindingElement class.

.NET Framework
Available since 3.0

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show: