BindingElementCollection Class

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Represents the collection of binding elements used in a binding.

Inheritance Hierarchy

System.Object
  System.Collections.ObjectModel.Collection<BindingElement>
    System.ServiceModel.Channels.BindingElementCollection

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

Syntax

'Declaration
Public Class BindingElementCollection _
    Inherits Collection(Of BindingElement)
public class BindingElementCollection : Collection<BindingElement>

The BindingElementCollection type exposes the following members.

Constructors

  Name Description
Public methodSupported by Silverlight for Windows Phone BindingElementCollection() Initializes a new instance of the BindingElementCollection class.
Public methodSupported by Silverlight for Windows Phone BindingElementCollection(array<BindingElement[]) Initializes a new instance of the BindingElementCollection class from an array of binding elements.
Public methodSupported by Silverlight for Windows Phone BindingElementCollection(IEnumerable<BindingElement>) Initializes a new instance of the BindingElementCollection class from an enumerable set of binding elements.

Top

Properties

  Name Description
Public propertySupported by Silverlight for Windows Phone Count Gets the number of elements actually contained in the Collection<T>. (Inherited from Collection<T>.)
Public propertySupported by Silverlight for Windows Phone Item Gets or sets the element at the specified index. (Inherited from Collection<T>.)
Protected propertySupported by Silverlight for Windows Phone Items Gets a IList<T> wrapper around the Collection<T>. (Inherited from Collection<T>.)

Top

Methods

  Name Description
Public methodSupported by Silverlight for Windows Phone Add Adds an object to the end of the Collection<T>. (Inherited from Collection<T>.)
Public methodSupported by Silverlight for Windows Phone AddRange Adds binding elements from an array to the collection of binding elements.
Public methodSupported by Silverlight for Windows Phone Clear Removes all elements from the Collection<T>. (Inherited from Collection<T>.)
Protected methodSupported by Silverlight for Windows Phone ClearItems Removes all elements from the Collection<T>. (Inherited from Collection<T>.)
Public methodSupported by Silverlight for Windows Phone Clone Creates a copy of the binding element collection.
Public methodSupported by Silverlight for Windows Phone Contains(T) Determines whether an element is in the Collection<T>. (Inherited from Collection<T>.)
Public methodSupported by Silverlight for Windows Phone Contains(Type) Returns a value that indicates whether a specified type of binding element belongs to the collection of binding elements.
Public methodSupported by Silverlight for Windows Phone CopyTo Copies the entire Collection<T> to a compatible one-dimensional Array, starting at the specified index of the target array. (Inherited from Collection<T>.)
Public methodSupported by Silverlight for Windows Phone Equals(Object) Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodSupported by Silverlight for Windows Phone Finalize Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)
Public methodSupported by Silverlight for Windows Phone Find<T> Returns the first item of a specified type from the collection of binding elements.
Public methodSupported by Silverlight for Windows Phone FindAll<T> Returns all of the items of a specified type from the collection of binding elements.
Public methodSupported by Silverlight for Windows Phone GetEnumerator Returns an enumerator that iterates through the Collection<T>. (Inherited from Collection<T>.)
Public methodSupported by Silverlight for Windows Phone GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
Public methodSupported by Silverlight for Windows Phone GetType Gets the Type of the current instance. (Inherited from Object.)
Public methodSupported by Silverlight for Windows Phone IndexOf Searches for the specified object and returns the zero-based index of the first occurrence within the entire Collection<T>. (Inherited from Collection<T>.)
Public methodSupported by Silverlight for Windows Phone Insert Inserts an element into the Collection<T> at the specified index. (Inherited from Collection<T>.)
Protected methodSupported by Silverlight for Windows Phone InsertItem Inserts a binding element at a specified location within a collection of binding elements. (Overrides Collection<T>.InsertItem(Int32, T).)
Protected methodSupported by Silverlight for Windows Phone MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Public methodSupported by Silverlight for Windows Phone Remove(T) Removes the first occurrence of a specific object from the Collection<T>. (Inherited from Collection<T>.)
Public methodSupported by Silverlight for Windows Phone Remove<T>() Removes a binding element of a specified type from the collection of binding elements.
Public methodSupported by Silverlight for Windows Phone RemoveAll<T> Removes all of the binding elements of a specified type from the collection of binding elements.
Public methodSupported by Silverlight for Windows Phone RemoveAt Removes the element at the specified index of the Collection<T>. (Inherited from Collection<T>.)
Protected methodSupported by Silverlight for Windows Phone RemoveItem Removes the element at the specified index of the Collection<T>. (Inherited from Collection<T>.)
Protected methodSupported by Silverlight for Windows Phone SetItem Replaces a binding element at the specified index in the collection of binding elements. (Overrides Collection<T>.SetItem(Int32, T).)
Public methodSupported by Silverlight for Windows Phone ToString Returns a string that represents the current object. (Inherited from Object.)

Top

Explicit Interface Implementations

  Name Description
Explicit interface implemetationPrivate methodSupported by Silverlight for Windows Phone ICollection.CopyTo Copies the elements of the ICollection to an Array, starting at a particular Array index. (Inherited from Collection<T>.)
Explicit interface implemetationPrivate propertySupported by Silverlight for Windows Phone ICollection<T>.IsReadOnly Gets a value indicating whether the ICollection<T> is read-only. (Inherited from Collection<T>.)
Explicit interface implemetationPrivate propertySupported by Silverlight for Windows Phone ICollection.IsSynchronized Gets a value indicating whether access to the ICollection is synchronized (thread safe). (Inherited from Collection<T>.)
Explicit interface implemetationPrivate propertySupported by Silverlight for Windows Phone ICollection.SyncRoot Gets an object that can be used to synchronize access to the ICollection. (Inherited from Collection<T>.)
Explicit interface implemetationPrivate methodSupported by Silverlight for Windows Phone IEnumerable.GetEnumerator Returns an enumerator that iterates through a collection. (Inherited from Collection<T>.)
Explicit interface implemetationPrivate methodSupported by Silverlight for Windows Phone IList.Add Adds an item to the IList. (Inherited from Collection<T>.)
Explicit interface implemetationPrivate methodSupported by Silverlight for Windows Phone IList.Contains Determines whether the IList contains a specific value. (Inherited from Collection<T>.)
Explicit interface implemetationPrivate methodSupported by Silverlight for Windows Phone IList.IndexOf Determines the index of a specific item in the IList. (Inherited from Collection<T>.)
Explicit interface implemetationPrivate methodSupported by Silverlight for Windows Phone IList.Insert Inserts an item into the IList at the specified index. (Inherited from Collection<T>.)
Explicit interface implemetationPrivate propertySupported by Silverlight for Windows Phone IList.IsFixedSize Gets a value indicating whether the IList has a fixed size. (Inherited from Collection<T>.)
Explicit interface implemetationPrivate propertySupported by Silverlight for Windows Phone IList.IsReadOnly Gets a value indicating whether the IList is read-only. (Inherited from Collection<T>.)
Explicit interface implemetationPrivate propertySupported by Silverlight for Windows Phone IList.Item Gets or sets the element at the specified index. (Inherited from Collection<T>.)
Explicit interface implemetationPrivate methodSupported by Silverlight for Windows Phone IList.Remove Removes the first occurrence of a specific object from the IList. (Inherited from Collection<T>.)

Top

Examples


            ' Inspect a binding by examining the collection of binding elements.
            Dim basicHttpBinding As New BasicHttpBinding()
            Dim bindingEC As BindingElementCollection = basicHttpBinding.CreateBindingElements()

            'Check on binding elements contained in the collection
            Dim boolHTBE As Boolean = bindingEC.Contains(GetType(HttpTransportBindingElement))
            'Returns true
            Dim txtboolHTBE As String = boolHTBE.ToString()
            Dim boolHSTBE As Boolean = bindingEC.Contains(GetType(HttpsTransportBindingElement))
            'Returns false
            Dim txtboolHSTBE As String = boolHSTBE.ToString()

            ' Find and retrieve the transport binding element from the collection.
            Dim bindingElement = bindingEC.Find(Of HttpTransportBindingElement)()
            Dim txtBE As String = bindingElement.GetType().ToString()

            ' Bind text outputs to XAML elements to display results.
            txtOutput1.Text = txtboolHTBE ' Output is: True
            txtOutput2.Text = txtboolHSTBE ' Output is: False
            txtOutput3.Text = txtBE ' Output is: System.ServiceModel.Channels.BindingElementCollection


            // Inspect a binding by examining the collection of binding elements.
            BasicHttpBinding basicHttpBinding = new BasicHttpBinding();
            BindingElementCollection bindingEC = basicHttpBinding.CreateBindingElements();

            //Check on binding elements contained in the collection
            bool boolHTBE = bindingEC.Contains(typeof(HttpTransportBindingElement));
            //Returns true
            string txtboolHTBE = boolHTBE.ToString();
            bool boolHSTBE = bindingEC.Contains(typeof(HttpsTransportBindingElement));
            //Returns false
            string txtboolHSTBE = boolHSTBE.ToString();

            // Find and retrieve the transport binding element from the collection.
            var bindingElement = bindingEC.Find<HttpTransportBindingElement>();
            string txtBE = bindingElement.GetType().ToString();

            // Bind text outputs to XAML elements to display results.
            txtOutput1.Text = txtboolHTBE; // Output is: True
            txtOutput2.Text = txtboolHSTBE; // Output is: False
            txtOutput3.Text = txtBE; // Output is: System.ServiceModel.Channels.BindingElementCollection

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Thread Safety

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