Data and Value Binding
The DropDownList enables you to configure the predefined list of options by setting its
data property and the selected value by setting its
To bind the DropDownList to data, use the
data property of the component.
data property accepts both:
Datasets of Objects
If the DropDownList is bound to a dataset of objects, the value of the component will correspond to the selected object. To implement the approach, set the
By default, the DropDownList compares the items by reference. To specify a field from the data object which will be used for the comparison, utilize the
dataItemKey property. The
dataItemKey property is useful when the reference to the selected item which is configured in the
defaultValue property do not match its corresponding item from the
data collection. If
dataItemKey is not set and the references in
value do not correspond, the selected item will not be highlighted in the drop-down list.
Arrays of Primitive Values
The following example demonstrates how to bind the DropDownList to an array of primitive values.
To render the selected value, use the
value property of the DropDownList. If you set the value through the
value property, hook up to the
onChange event and manually update the value of the