CustomBindingElement Class

Definition

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

public ref class CustomBindingElement : System::ServiceModel::Configuration::NamedServiceModelExtensionCollectionElement<System::ServiceModel::Configuration::BindingElementExtensionElement ^>, System::Collections::Generic::ICollection<System::ServiceModel::Configuration::BindingElementExtensionElement ^>, System::Collections::Generic::IEnumerable<System::ServiceModel::Configuration::BindingElementExtensionElement ^>, System::ServiceModel::Configuration::IBindingConfigurationElement
public class CustomBindingElement : System.ServiceModel.Configuration.NamedServiceModelExtensionCollectionElement<System.ServiceModel.Configuration.BindingElementExtensionElement>, System.Collections.Generic.ICollection<System.ServiceModel.Configuration.BindingElementExtensionElement>, System.Collections.Generic.IEnumerable<System.ServiceModel.Configuration.BindingElementExtensionElement>, System.ServiceModel.Configuration.IBindingConfigurationElement
type CustomBindingElement = class
    inherit NamedServiceModelExtensionCollectionElement<BindingElementExtensionElement>
    interface ICollection<BindingElementExtensionElement>
    interface seq<BindingElementExtensionElement>
    interface IEnumerable
    interface IBindingConfigurationElement
Public Class CustomBindingElement
Inherits NamedServiceModelExtensionCollectionElement(Of BindingElementExtensionElement)
Implements IBindingConfigurationElement, ICollection(Of BindingElementExtensionElement), IEnumerable(Of BindingElementExtensionElement)
Inheritance
Implements

Remarks

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)

Constructors

CustomBindingElement()

Initializes a new instance of the CustomBindingElement class.

CustomBindingElement(String)

Initializes a new instance of the CustomBindingElement class with the specified name.

Properties

CloseTimeout

Gets or sets the interval of time provided for a close operation to complete.

Count

Gets the number of items in this collection.

(Inherited from ServiceModelExtensionCollectionElement<TServiceModelExtensionElement>)
CurrentConfiguration

Gets a reference to the top-level Configuration instance that represents the configuration hierarchy that the current ConfigurationElement instance belongs to.

(Inherited from ConfigurationElement)
ElementInformation

Gets an ElementInformation object that contains the non-customizable information and functionality of the ConfigurationElement object.

(Inherited from ConfigurationElement)
ElementProperty

Gets the ConfigurationElementProperty object that represents the ConfigurationElement object itself.

(Inherited from ConfigurationElement)
EvaluationContext

Gets the ContextInformation object for the ConfigurationElement object.

(Inherited from ConfigurationElement)
HasContext

Gets a value that indicates whether the CurrentConfiguration property is null.

(Inherited from ConfigurationElement)
Item[ConfigurationProperty]

Gets or sets a property or attribute of this configuration element.

(Inherited from ConfigurationElement)
Item[Int32]

Gets the item at the specified index within the collection.

(Inherited from ServiceModelExtensionCollectionElement<TServiceModelExtensionElement>)
Item[String]

Gets or sets a property, attribute, or child element of this configuration element.

(Inherited from ConfigurationElement)
Item[Type]

Gets the item of the specified type within the collection.

(Inherited from ServiceModelExtensionCollectionElement<TServiceModelExtensionElement>)
LockAllAttributesExcept

Gets the collection of locked attributes.

(Inherited from ConfigurationElement)
LockAllElementsExcept

Gets the collection of locked elements.

(Inherited from ConfigurationElement)
LockAttributes

Gets the collection of locked attributes.

(Inherited from ConfigurationElement)
LockElements

Gets the collection of locked elements.

(Inherited from ConfigurationElement)
LockItem

Gets or sets a value indicating whether the element is locked.

(Inherited from ConfigurationElement)
Name

Gets or sets the name of this collection.

(Inherited from NamedServiceModelExtensionCollectionElement<TServiceModelExtensionElement>)
OpenTimeout

Gets or sets the interval of time provided for an open operation to complete.

Properties

Gets a ConfigurationPropertyCollection instance that contains a collection of ConfigurationProperty objects that can be attributes or ConfigurationElement objects of this configuration element.

ReceiveTimeout

Gets or sets the interval of time provided for a receive operation to complete.

SendTimeout

Gets or sets the interval of time provided for a send operation to complete.

Methods

Add(BindingElementExtensionElement)

Adds the specified element to this configuration section.

Add(TServiceModelExtensionElement)

Adds the specified element to this configuration section.

(Inherited from ServiceModelExtensionCollectionElement<TServiceModelExtensionElement>)
ApplyConfiguration(Binding)

Applies the content of the specified binding to this binding configuration element. This method cannot be inherited.

CanAdd(BindingElementExtensionElement)

Adds a new behavior element to this section and returns a value indicating if the operation is successful.

CanAdd(TServiceModelExtensionElement)

Adds a new behavior element to this section and returns a value that indicates whether the operation is successful.

(Inherited from ServiceModelExtensionCollectionElement<TServiceModelExtensionElement>)
Clear()

Deletes all elements in this collection. This method cannot be inherited.

(Inherited from ServiceModelExtensionCollectionElement<TServiceModelExtensionElement>)
Contains(TServiceModelExtensionElement)

Returns a value that indicates whether this collection contains a specific element. This method cannot be inherited.

(Inherited from ServiceModelExtensionCollectionElement<TServiceModelExtensionElement>)
ContainsKey(String)

Determines whether this collection contains an element of the specified name.

(Inherited from ServiceModelExtensionCollectionElement<TServiceModelExtensionElement>)
ContainsKey(Type)

Determines whether this collection contains an element of the specified type.

(Inherited from ServiceModelExtensionCollectionElement<TServiceModelExtensionElement>)
CopyTo(TServiceModelExtensionElement[], Int32)

Copies the entire collection to a compatible one-dimensional array, starting at the specified index of the target array. This method cannot be inherited.

(Inherited from ServiceModelExtensionCollectionElement<TServiceModelExtensionElement>)
DeserializeElement(XmlReader, Boolean)

Reads XML from the configuration file.

(Inherited from ServiceModelExtensionCollectionElement<TServiceModelExtensionElement>)
Equals(Object)

Compares the current ConfigurationElement instance to the specified object.

(Inherited from ConfigurationElement)
GetEnumerator()

Returns an IEnumerator that iterates through a collection. This method cannot be inherited.

(Inherited from ServiceModelExtensionCollectionElement<TServiceModelExtensionElement>)
GetHashCode()

Gets a unique value representing the current ConfigurationElement instance.

(Inherited from ConfigurationElement)
GetTransformedAssemblyString(String)

Returns the transformed version of the specified assembly name.

(Inherited from ConfigurationElement)
GetTransformedTypeString(String)

Returns the transformed version of the specified type name.

(Inherited from ConfigurationElement)
GetType()

Gets the Type of the current instance.

(Inherited from Object)
Init()

Sets the ConfigurationElement object to its initial state.

(Inherited from ConfigurationElement)
InitializeDefault()

Used to initialize a default set of values for the ConfigurationElement object.

(Inherited from ConfigurationElement)
IsModified()

Indicates whether this configuration element has been modified since it was last saved or loaded, when implemented in a derived class.

(Inherited from ServiceModelExtensionCollectionElement<TServiceModelExtensionElement>)
IsReadOnly()

Gets a value indicating whether the ConfigurationElement object is read-only.

(Inherited from ConfigurationElement)
ListErrors(IList)

Adds the invalid-property errors in this ConfigurationElement object, and in all subelements, to the passed list.

(Inherited from ConfigurationElement)
MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
OnApplyConfiguration(Binding)

Called when the content of a specified binding element is applied to this binding configuration element.

OnDeserializeUnrecognizedAttribute(String, String)

Gets a value indicating whether an unknown attribute is encountered during deserialization.

(Inherited from ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)

Gets a value that indicates whether an unknown element is encountered during deserialization.

(Inherited from ServiceModelExtensionCollectionElement<TServiceModelExtensionElement>)
OnRequiredPropertyNotFound(String)

Throws an exception when a required property is not found.

(Inherited from ConfigurationElement)
PostDeserialize()

Called after deserialization.

(Inherited from ConfigurationElement)
PreSerialize(XmlWriter)

Called before serialization.

(Inherited from ConfigurationElement)
Remove(TServiceModelExtensionElement)

Removes the specified element from the collection. This method cannot be inherited.

(Inherited from ServiceModelExtensionCollectionElement<TServiceModelExtensionElement>)
Reset(ConfigurationElement)

Resets this collection to its unmodified state when overridden in a derived class.

(Inherited from ServiceModelExtensionCollectionElement<TServiceModelExtensionElement>)
ResetModified()

Resets the value of the IsModified() property to false when overridden in a derived class.

(Inherited from ServiceModelExtensionCollectionElement<TServiceModelExtensionElement>)
SerializeElement(XmlWriter, Boolean)

Writes the contents of this configuration element to the configuration file when implemented in a derived class.

(Inherited from ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)

Writes the outer tags of this configuration element to the configuration file when implemented in a derived class.

(Inherited from ConfigurationElement)
SetIsModified()

Sets the IsModified() property for this collection.

(Inherited from ServiceModelExtensionCollectionElement<TServiceModelExtensionElement>)
SetPropertyValue(ConfigurationProperty, Object, Boolean)

Sets a property to the specified value.

(Inherited from ConfigurationElement)
SetReadOnly()

Sets the internal IsReadOnly property for this collection and for all sub-elements.

(Inherited from ServiceModelExtensionCollectionElement<TServiceModelExtensionElement>)
ToString()

Returns a string that represents the current object.

(Inherited from Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)

Reverses the effect of merging configuration information from different levels of the configuration hierarchy.

(Inherited from ServiceModelExtensionCollectionElement<TServiceModelExtensionElement>)

Explicit Interface Implementations

ICollection<TServiceModelExtensionElement>.IsReadOnly

Gets a value that indicates whether this ServiceModelExtensionCollectionElement<TServiceModelExtensionElement> is read-only.

(Inherited from ServiceModelExtensionCollectionElement<TServiceModelExtensionElement>)
IEnumerable.GetEnumerator()

Returns an IEnumerator that iterates through a collection. This method cannot be inherited.

(Inherited from ServiceModelExtensionCollectionElement<TServiceModelExtensionElement>)

Extension Methods

CopyToDataTable<T>(IEnumerable<T>)

Returns a DataTable that contains copies of the DataRow objects, given an input IEnumerable<T> object where the generic parameter T is DataRow.

CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption)

Copies DataRow objects to the specified DataTable, given an input IEnumerable<T> object where the generic parameter T is DataRow.

CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption, FillErrorEventHandler)

Copies DataRow objects to the specified DataTable, given an input IEnumerable<T> object where the generic parameter T is DataRow.

Cast<TResult>(IEnumerable)

Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Enables parallelization of a query.

AsQueryable(IEnumerable)

Converts an IEnumerable to an IQueryable.

Ancestors<T>(IEnumerable<T>)

Returns a collection of elements that contains the ancestors of every node in the source collection.

Ancestors<T>(IEnumerable<T>, XName)

Returns a filtered collection of elements that contains the ancestors of every node in the source collection. Only elements that have a matching XName are included in the collection.

DescendantNodes<T>(IEnumerable<T>)

Returns a collection of the descendant nodes of every document and element in the source collection.

Descendants<T>(IEnumerable<T>)

Returns a collection of elements that contains the descendant elements of every element and document in the source collection.

Descendants<T>(IEnumerable<T>, XName)

Returns a filtered collection of elements that contains the descendant elements of every element and document in the source collection. Only elements that have a matching XName are included in the collection.

Elements<T>(IEnumerable<T>)

Returns a collection of the child elements of every element and document in the source collection.

Elements<T>(IEnumerable<T>, XName)

Returns a filtered collection of the child elements of every element and document in the source collection. Only elements that have a matching XName are included in the collection.

InDocumentOrder<T>(IEnumerable<T>)

Returns a collection of nodes that contains all nodes in the source collection, sorted in document order.

Nodes<T>(IEnumerable<T>)

Returns a collection of the child nodes of every document and element in the source collection.

Remove<T>(IEnumerable<T>)

Removes every node in the source collection from its parent node.

Applies to

See also