Tab
A newer version of this page is available. Switch to the current version.

AutoCompleteBoxPropertiesBase.ValueField Property

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

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v18.2.dll

Declaration

[DefaultValue("")]
public string ValueField { get; set; }
<DefaultValue("")>
Public Property ValueField As String

Property Value

Type Default Description
String

String.Empty

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

Remarks

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".

NOTE

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

Example

The following example illustrates how to use the ValueField property.

WebForms approach:

NOTE

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"
    EnableSynchronization="False">
    <ClientSideEvents SelectedIndexChanged="function(s, e) { OnCountryChanged(s); }" />
</dx:ASPxComboBox>

MVC approach:

NOTE

For a full example, refer to MVC ComboBox Extension -