ControlBindingsCollection.Item[String] Property

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Gets the Binding specified by the control's property name.

public:
 property System::Windows::Forms::Binding ^ default[System::String ^] { System::Windows::Forms::Binding ^ get(System::String ^ propertyName); };

public System.Windows.Forms.Binding? this[string propertyName] { get; }

member this.Item(string) : System.Windows.Forms.Binding

Default Public ReadOnly Property Item(propertyName As String) As Binding

Parameters

propertyName

String

The name of the property on the data-bound control.

Property Value

Binding

The Binding that binds the specified control property to a data source.

Examples

The following code example returns a single Binding from a ControlBindingsCollection.

void PrintValue()
{
   ControlBindingsCollection^ myControlBindings;
   myControlBindings = textBox1->DataBindings;
   
   // Get the Binding for the Text property.
   Binding^ myBinding = myControlBindings[ "Text" ];
   
   // Assuming the data source is a DataTable.
   DataRowView^ drv;
   drv = dynamic_cast<DataRowView^>(myBinding->BindingManagerBase->Current);
   
   // Assuming a column named S"custName" exists, print the value.
   Console::WriteLine( drv[ "custName" ] );
}

private void PrintValue()
{
   ControlBindingsCollection myControlBindings;
   myControlBindings = textBox1.DataBindings;

   // Get the Binding for the Text property.
   Binding myBinding = myControlBindings["Text"];

   // Assuming the data source is a DataTable.
   DataRowView drv;
   drv = (DataRowView) myBinding.BindingManagerBase.Current;

   // Assuming a column named "custName" exists, print the value.
   Console.WriteLine(drv["custName"]);
}

Private Sub PrintValue()

   Dim myControlBindings As ControlBindingsCollection = _
   textBox1.DataBindings

   ' Get the Binding for the Text property.
   Dim myBinding As Binding = myControlBindings("Text")

   ' Assuming the data source is a DataTable.
   Dim drv As DataRowView = _
   CType( myBinding.BindingManagerBase.Current, DataRowView)

   ' Assuming a column named "custName" exists, print the value.
   Console.WriteLine(drv("custName"))
End Sub

Remarks

If the specified property does not match a binding in the collection, Item[] returns null.