# ComboBox Data Binding

This article explains the different ways to provide data to a ComboBox component, the properties related to data binding and their results.

For details on Value Binding and Data Binding, and the differences between them, see the [Data Binding vs Value Binding](https://www.telerik.com/blazor-ui/documentation/common-features/data-binding/overview#data-binding-vs-value-binding) section.

There are two key ways to bind data:

* [Strings and Value Types](https://www.telerik.com/blazor-ui/documentation/components/combobox/data-bind#strings-and-value-types)
* [Model](https://www.telerik.com/blazor-ui/documentation/components/combobox/data-bind#bind-to-a-model)

There are also some considerations you may find useful, such as showing the `Placeholder` when the value is out of the data source range:

* [Considerations](https://www.telerik.com/blazor-ui/documentation/components/combobox/data-bind#considerations)
  * [Value Out of Range](https://www.telerik.com/blazor-ui/documentation/components/combobox/data-bind#value-out-of-range)
  * [Missing Value or Data](https://www.telerik.com/blazor-ui/documentation/components/combobox/data-bind#missing-value-or-data)

## Strings and Value Types

You can data bind the ComboBox to a collection of `string` or [value type](https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/builtin-types/value-types) data (such as `int`, `decimal`, `bool`, `Guid`, and `Enum`). When you have a concrete list of options for the user to choose from, their string representation is often suitable for display and you do not need special models.

To bind the combobox to string or value type data, you need to:

1. provide an `IEnumerable<TItem>` of the desired type to its `Data` property
2. set a corresponding `Value`. If the `Value` is `null`, it will be populated with the first item from the data source.

> caption Data binding a ComboBox to string data

<demo metaUrl="client/combobox/data-bind/simple/" height="220"></demo>

## Bind to a Model

You can bind the ComboBox to a model in your application. This is useful when you have a numerical representation of a finite list (for example, departments in a company), and you want the user to choose them based on a friendly text name.

To bind the ComboBox to a model:

1. Populate its `Data` parameter with the collection of items you want in the dropdown.
2. Set the `TextField` and `ValueField` parameters to point to the corresponding property names of the model.
3. Set the `Value` property to the initial value of the component (optional).

> The `TextField` and `ValueField` parameters must point to `string` or [value type](https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/builtin-types/value-types) properties. The `Value` parameter type must match the type of the `ValueField` property.

> caption Data binding a ComboBox to a model

<demo metaUrl="client/combobox/data-bind/model/" height="280"></demo>

> tip If you are looking for more fields from the view-model that describes the dropdown items, not just the `Value`, see the [Get model from dropdown](https://www.telerik.com/blazor-ui/documentation/knowledge-base/dropdowns-get-model) KB article and the [OnChange](https://www.telerik.com/blazor-ui/documentation/components/combobox/events#onchange) event.
>
> You may also want to review/join the discussion and Vote for this request: <a href="https://www.telerik.com/forums/binding-dropdownlist-value-to-complex-model" target="_blank">Binding DropDownList Value to complex model</a>

## Considerations

The ComboBox component attempts to infer the type of its model and value based on the provided `Data` and initial `Value`. This affects the way its [reference is obtained](https://www.telerik.com/blazor-ui/documentation/common-features/data-binding/overview#component-type) and what happens [if you can't provide data or a value](https://www.telerik.com/blazor-ui/documentation/components/combobox/data-bind#missing-value-or-data). Providing a [value that is not in the data source](https://www.telerik.com/blazor-ui/documentation/components/combobox/data-bind#value-out-of-range) needs to be taken into account by the app, because the component will not change it.

### Value Out of Range

This specific is applicable for the case when [custom value input](https://www.telerik.com/blazor-ui/documentation/components/combobox/custom-value) is disabled (`AllowCustom="false"` which is its default value).

When the `Value` the application provides does not match any of the values present in the `ValueField` of the `Data` collection, the ComboBox component will not change the `Value` or select a new item. In the common case, it will show up blank to indicate there is nothing selected from its data.

If you have set the `Placeholder` and the `Value` matches the `default` value of the type (for example, `0` for an `int` or `null` for an `int?` or `string`), you will see the `Placeholder`. A `Value` that is non-`default` will not show the `Placeholder`.

Handling such "unexpected" values is up to the application - for example, through defensive checks, or through form validation, or by first checking what is present in the data source before setting a new `Value`.

When `AllowCustom="true"`, what the user types in the input will be set to the `Value` of the component regardless of the data source.

### Missing Value or Data

In case you cannot provide strongly-typed `Value` or `Data` at compile time, you need to set the corresponding type properties to the `TItem` and `TValue` properties as shown below.

> caption ComboBox configuration if you cannot provide Value or Data

<demo metaUrl="client/combobox/data-bind/missing-value-data/" height="250"></demo>

## See Also

* [Blazor ComboBox Overview](https://www.telerik.com/blazor-ui/documentation/components/combobox/overview)
* [Live Demo: ComboBox](https://demos.telerik.com/blazor-ui/combobox/overview)
