Tab

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

Declaration

[DefaultValue("")]
public string ValueField { get; set; }

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.

Web Forms 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>