# Data and Value Binding

The DropDownList enables you to configure the predefined list of options by setting its [`data`](https://www.telerik.com/kendo-react-ui/components/dropdowns/api/dropdownlistprops#data) property and the selected value by setting its [`value`](https://www.telerik.com/kendo-react-ui/components/dropdowns/api/dropdownlistprops#value) property.

## Data Binding

To bind the DropDownList to data, use the [`data`](https://www.telerik.com/kendo-react-ui/components/dropdowns/api/dropdownlistprops#data) property of the component.

The `data` property accepts both:

* [Datasets of objects](https://www.telerik.com/kendo-react-ui/components/dropdowns/dropdownlist/binding#datasets-of-objects), and
* [Arrays of primitive values](https://www.telerik.com/kendo-react-ui/components/dropdowns/dropdownlist/binding#arrays-of-primitive-values).

### 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 [`textField`](https://www.telerik.com/kendo-react-ui/components/dropdowns/api/dropdownlistprops#textfield) property.

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`](https://www.telerik.com/kendo-react-ui/components/dropdowns/api/dropdownlistprops#dataitemkey) property. The `dataItemKey` property is useful when the reference to the selected item which is configured in the `value` or `defaultValue` property do not match its corresponding item from the `data` collection. If `dataItemKey` is not set and the references in `data` and `value` do not correspond, the selected item will not be highlighted in the drop-down list.

[Demo Source](https://demos.telerik.com/kendo-react-ui/dropdowns/dropdownlist/complex-value/func/source.txt)

### Arrays of Primitive Values

The following example demonstrates how to bind the DropDownList to an array of primitive values.

[Demo Source](https://demos.telerik.com/kendo-react-ui/dropdowns/dropdownlist/primitive-value/func/source.txt)

## Value Binding

To render the selected value, use the [`value`](https://www.telerik.com/kendo-react-ui/components/dropdowns/api/dropdownlistprops#value) property of the DropDownList. If you set the value through the `value` property, hook up to the [`onChange`](https://www.telerik.com/kendo-react-ui/components/dropdowns/api/dropdownlistprops#onchange) event and manually update the value of the `value` property.

[Demo Source](https://demos.telerik.com/kendo-react-ui/dropdowns/dropdownlist/controlled/func/source.txt)

## Suggested Links

* [Learn about KendoReact Free.](https://www.telerik.com/kendo-react-ui/components/getting-started/free-vs-premium)

* [API Reference of the DropDownList](https://www.telerik.com/kendo-react-ui/components/dropdowns/api/dropdownlistprops)

* [Controlled Components in React](https://react.dev/learn/sharing-state-between-components#controlled-and-uncontrolled-components)
