Skip to main content

ASPxDropDownEdit Class

An editor that provides the drop-down list functionality.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v23.1.dll

NuGet Package: DevExpress.Web


public class ASPxDropDownEdit :


The ASPxDropDownEdit provides an edit box to display the editor value and a specific drop-down button that opens a dropdown window. The drop-down edit control allows you to define its value based on the value(s) of a control(s) integrated into the editor’s drop-down window.

DropDownEdit Control

Create a Drop Down Edit

Design Time

The ASPxDropDownEdit control is available on the DX.23.1: Common Controls toolbox tab in the Microsoft Visual Studio IDE.

DropDownEdit in Toolbox

Drag the control onto a form and customize the control’s settings, or paste the control markup in the page’s source code.


To properly function, DevExpress controls require that special modules, handlers and options are registered in the the Web.config file. Switch the Microsoft Visual Studio IDE to the Design tab to automatically update the Web.config file with the required DevExpress information.

<dx:ASPxDropDownEdit ID="ASPxDropDownEdit1" runat="server">

Run Time

using DevExpress.Web;
protected void Page_Load(object sender, EventArgs e)
    ASPxDropDownEdit de = new ASPxDropDownEdit();
    de.ID = "ASPxDropDownEdit1";

    de.ClearButton.DisplayMode = ClearButtonDisplayMode.Always;
    de.ClearButton.Position = ButtonsPosition.Right;

Client-Side API

The ASPxDropDownEdit’s client-side API is implemented with JavaScript language and exposed by the ASPxClientDropDownEdit object.


Available by default.

Client object type


Access name





When ASPxDropDownEdit’s ASPxEdit.Enabled property is set to false, the drop-down window elements are not rendered. This behavior is designed to reduce unnecessary markup when the editor is disabled. Use the ASPxEditBase.ClientEnabled property to have the disabled drop-down edit control with rendered content.


You can use templates to specify the control’s content - button (ASPxDropDownEdit.ButtonTemplate) and drop-down window (ASPxDropDownEdit.DropDownWindowTemplate).

<dx:ASPxDropDownEdit ClientInstanceName="checkComboBox" ID="ASPxDropDownEdit1" ...>    
        <dx:ASPxListBox Width="100%" ID="listBox" ...>

See demo

Null Prompt Text

You can use the editor’s NullText property to display a prompt in the editor’s edit box. The prompt text disappears when the editor receives focus.

<dx:ASPxDropDownEdit ID="ASPxDropDownEdit1" runat="server" NullText="Test Text" >

See demo

Button Collection

The drop-down edit control allows you to create custom edit buttons (Buttons).

<dx:ASPxDropDownEdit ID="ASPxDropDownEdit1" runat="server"  >
        <dx:EditButton Text="Button1">


The drop-down edit control allows you to validate its data on the client and server side.

<dx:ASPxDropDownEdit ID="ASPxDropDownEdit1" ClientInstanceName="dde" runat="server" >
        <RequiredField IsRequired="true" />

Online Demos

See Also