ASPxGridLookup.SelectionMode Property

Gets or sets a value that specifies item selection behavior.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v25.2.dll

NuGet Package: DevExpress.Web

Declaration

C#

[DefaultValue(GridLookupSelectionMode.Single)]
public GridLookupSelectionMode SelectionMode { get; set; }

VB.NET

<DefaultValue(GridLookupSelectionMode.Single)>
Public Property SelectionMode As GridLookupSelectionMode

Property Value

Type	Default	Description
GridLookupSelectionMode	Single	One of the GridLookupSelectionMode enumeration values.

Available values:

Name	Description
Single	Only one list item can be selected at one time.
Multiple	Multiple items can be selected within the editor’s dropdown list.

Remarks

The SelectionMode property specifies how many list items (grid rows) can be selected simulateneously within the dropdown ASPxGridView control.

ASPX

<dx:ASPxGridLookup ID="gridLookup" runat="server" SelectionMode="Multiple" ...>
    <Columns>
        <dx:GridViewCommandColumn ShowSelectCheckbox="True" SelectAllCheckboxMode="AllPages" />
        <!-- ... -->
    </Columns>
    <!-- ... -->
</dx:ASPxGridLookup>

View Example: How to enable multiple selection

For more information about available selection modes, read the Selection Modes topic.

Note

• When the multiple selection mode is enabled (the SelectionMode property is set to Multiple), incremental filtering does not work.
• In single-selection mode, the GridLookup always synchronizes its value with the focused row in the drop-down grid when a user sorts grid columns, navigates through pages,etc. You can press ESC to rollback a newly selected value and restore an original editor’s value.

Note

The SelectionMode property synchronizes its value with the ASPxGridViewBehaviorSettings.AllowSelectSingleRowOnly property (which can be accessed through the GridViewProperties.SettingsBehavior property).

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the SelectionMode property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

xaf-how-to-display-an-enumeration-property-as-a-drop-down-box-with-check-boxes/CS/E689.Module.Web/Editors/ASPxEnumPropertyEditorEx.cs#L31

lookupEdit.Width = Unit.Percentage(100);
lookupEdit.SelectionMode = GridLookupSelectionMode.Multiple;
lookupEdit.TextChanged += EditValueChangedHandler;

VB.NET

xaf-how-to-display-an-enumeration-property-as-a-drop-down-box-with-check-boxes/VB/E689.Module.Web/Editors/ASPxEnumPropertyEditorEx.vb#L30

lookupEdit.Width = Unit.Percentage(100)
lookupEdit.SelectionMode = GridLookupSelectionMode.Multiple
AddHandler lookupEdit.TextChanged, AddressOf EditValueChangedHandler