This documentation is archived and is not being maintained.

CustomBindingElement Class

Represents the configuration section that provides full control over the messaging stack for the user.

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

Public Class CustomBindingElement _
	Inherits NamedServiceModelExtensionCollectionElement(Of BindingElementExtensionElement) _
	Implements ICollection(Of BindingElementExtensionElement), IEnumerable(Of BindingElementExtensionElement),  _
	IEnumerable, IBindingConfigurationElement
Dim instance As CustomBindingElement

Custom bindings provide full control over the Windows Communication Foundation (WCF) messaging stack. An individual binding defines the message stack by specifying the configuration elements for the stack elements in the order they appear on the stack. Each element defines and configures the one element of the stack. There must be one and only one transport element in each custom binding. Without this element, the messaging stack is incomplete.

The order in which elements appear in the stack matters, because it is the order in which operations are applied to the message. The recommended order of stack elements is the following:

  1. Transactions (optional)

  2. Reliable Messaging (optional)

  3. Security (optional)

  4. Transport

  5. Encoder (optional)

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

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0