System.ServiceModel 4.0.0.0 System.ServiceModel.Channels.Binding System.ServiceModel.Channels.IBindingRuntimePreferences

The provides the same support for Web Service protocols as the , but for use with duplex contracts. only supports SOAP security and requires reliable messaging. This binding requires that the client has a public URI that provides a callback endpoint for the service. This is provided by the . A dual binding exposes the IP address of the client to the service. The client should use security to ensure that it only connects to services it trusts.

By default the generates the following binding element stack:

A secure and interoperable binding that is designed for use with duplex service contracts that allows both services and clients to send and receive messages.

- Constructor
  4.0.0.0
  To be added.

  Initializes a new instance of the class.

- Constructor
  4.0.0.0

  Reliable messaging is required by the , so there is no constructor that provides a switch to turn it off as there is on the constructor for the .

  Initializes a new instance of the class with a specified type of security used by the binding.

  The value of that specifies the type of security that is used with the SOAP message and for the client.
- Property
  4.0.0.0
  System.Boolean To be added.

  An Internet resource is local if it has a local address. A local address is one that is on the same computer, the local LAN or intranet and is identified, syntactically, by the lack of a period (.) as in the URIs "http://webserver/" and "http://localhost/".

  Setting the property determines whether endpoints configured with the use the proxy server when accessing local resources.

  If is true, requests to local Internet resources do not use the proxy server. Use the host name (rather than localhost) if you want clients to go through a proxy when talking to services on the same machine when this property is set to true.

  When is false, all Internet requests are made through the proxy server.

  Gets or sets a value that indicates whether to bypass the proxy server for local addresses.

- Property
  4.0.0.0
  System.Uri To be added.

  This public URI for the client provides the callback endpoint required for the service to contact the client when the contract is duplex.

  Gets or sets the base address of the client.

- Method
  4.0.0.0
  System.ServiceModel.Channels.BindingElementCollection To be added.

  Returns an ordered collection of binding elements contained in the current binding.

  A that includes a and, because a reliable session is required for the , a .

- Property
  4.0.0.0
  System.ServiceModel.EnvelopeVersion To be added. To be added.

  Gets the version of SOAP that is used for messages that are processed by this binding.

- Property
  4.0.0.0
  System.ServiceModel.HostNameComparisonMode To be added. To be added.

  Gets or sets a value that indicates whether the hostname is used to reach the service when matching the URI.

- Property
  4.0.0.0
  System.Int64 To be added.

  The minimizes the cost of using buffers with a buffer pool. Buffers are required to process messages by the service when they come out of the channel. If there is not sufficient memory in the buffer pool to process the message load, the must allocate additional memory from the CLR heap, which increases the garbage collection overhead. Extensive allocation from the CLR garbage heap is an indication that the buffer pool size is too small and that performance can be improved with a larger allocation by increasing the limit.

  The limitations on buffer size set here are for optimizing the performance of message exchanges. If a message exceeds the maximum value set for the buffer, it is not dropped. Instead, more memory is requested from the CLR heap and this incurs more garbage collection overhead than using the buffers.

  Gets or sets the maximum amount of memory, in bytes, that can be allocated for the manager of message buffers that receive messages at the endpoints configured with this binding.

- Property
  4.0.0.0
  System.Int64 To be added.

  The size of the messages that can be received on the wire by services using the is bounded by the amount of memory allocated for each message. This bound on message size is intended to limit exposure to DOS-style attacks.

  Note that the settings for and are local behavioral settings. This means that they are not transmitted to other endpoints in metadata. If you generate a proxy to a service with a maximum message size of 2GB from metadata, the proxy still has a default value 64K. This leaves control of the appropriate bounds for message and message buffer size in the scope of local administrators.

  Gets or sets the maximum size, in bytes, for a message that can be received on a channel configured with this binding.

- Property
  4.0.0.0
  System.ServiceModel.WSMessageEncoding To be added. To be added.

  Gets or sets whether MTOM or Text/XML is used to encode SOAP messages.

- Property
  4.0.0.0
  System.Uri To be added.

  If the is set to true, the value of the is ignored.

  Gets or sets the URI address of the HTTP proxy.

- Property
  4.0.0.0
  System.Xml.XmlDictionaryReaderQuotas To be added.

  The complexity constraints include items such as a maximum element depth and a maximum length for string content within the message. The constraints protect against a class of denial of service (DOS) attacks that attempt to use message complexity to tie up endpoint processing resources.

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

- Property
  4.0.0.0
  System.ServiceModel.ReliableSession To be added.

  The reliable session is required for service configured with a .

  Gets an object that provides convenient access to the properties of a reliable session binding element that are available when using one of the system-provided bindings.

- Property
  4.0.0.0
  System.String To be added. To be added.

  Gets the URI transport scheme for the channels and listeners that are configured with this binding.

- Property
  4.0.0.0
  System.ServiceModel.WSDualHttpSecurity To be added.

  A dual binding exposes the IP address of the client to the service. The client should use security to ensure that it only connects to services it trusts.

  Gets an object that specifies the security settings used with this binding.

- Property
  4.0.0.0
  System.Boolean To be added.

  This value can be changed by using a service model behavior.

  Gets a value that indicates whether incoming requests are handled synchronously or asynchronously.

- Property
  4.0.0.0
  System.Text.Encoding To be added. To be added.

  Gets or sets the character encoding that is used for the message text.

- Property
  4.0.0.0
  System.Boolean To be added.

  The default value specifies that clients do not flow transactions and services reject messages with a flowed transaction message header.

  Gets or sets a value that indicates whether this binding should support flowing WS-Transactions.

- Property
  4.0.0.0
  System.Boolean To be added. To be added.

  Gets or sets a value that indicates whether the auto-configured HTTP proxy of the system should be used, if available.