AutoCompleteBoxPropertiesBase.ValueField Property

Gets or sets the data source field that provides values for the editor’s items.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v21.2.dll


public string ValueField { get; set; }

Property Value

Type Default Description


A string value that specifies the name of the data source field from which the editor obtains item values.


If a combobox editor is data bound (via the AutoCompleteBoxPropertiesBase.DataSourceID or AutoCompleteBoxPropertiesBase.DataSource property), the editor populates its AutoCompleteBoxPropertiesBase.Items collection by retrieving items from the specified data source and obtaining item characteristics (such as the item text, value or displayed image) from specific data fields. Use the ValueField property to specify a data source’s field from which the item values should be obtained.

If the ValueField property of a data bound combo box is not defined, the control can automatically obtain item values from a data field whose name is “Value”.


The ValueField property synchronizes its value with the editor’s ASPxAutoCompleteBoxBase.ValueField property.


The following example illustrates how to use the ValueField property.

Web Forms approach:


For a full example, see the ASPxComboBox - Cascading Combo Boxes demo.

<dx:ASPxComboBox runat="server" ID="CmbCountry" DropDownStyle="DropDownList" IncrementalFilteringMode="StartsWith"
    TextField="CountryName" ValueField="CountryName" Width="100%" DataSourceID="CountriesDataSource"
    <ClientSideEvents SelectedIndexChanged="function(s, e) { OnCountryChanged(s); }" />