ControlBindingsCollection.Item[String] Property

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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; }

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.

Applies to

Share via