[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Collapse]ASP.NET WebForms Controls
   Getting Started
  [Collapse]Grid View
   [Expand]Product Information
    Getting Started
   [Expand]Fundamentals
   [Collapse]Concepts
    [Expand]Binding to Data
    [Expand]Data Representation Basics
    [Expand]Focus and Navigation
    [Expand]Data Editing
    [Expand]Data Shaping and Manipulation
    [Expand]Data Formatting
    [Expand]Master-Detail Relationship
     Appearance Customization
     Adaptivity
     Save and Restore Layout
    [Expand]Templates
    [Expand]Export
     Toolbars
    [Collapse]ASPxGridLookup
      ASPxGridLookup - Overview
      Selection Modes
      Incremental Filtering
      Templates
     [Expand]Member Tables
     [Expand]Examples
    ASPxGridView Designer
   [Expand]Visual Elements
   [Expand]Examples
   [Expand]Member Tables
   [Expand]ASPxGridView - Animated Images
  [Expand]Tree List
  [Expand]Card View
  [Expand]Reporting
  [Expand]Chart Control
  [Expand]Pivot Grid
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Scheduler
  [Expand]Site Navigation and Layout
  [Expand]HTML Editor
  [Expand]Gauges
  [Expand]Vertical Grid
  [Expand]Data Editors
  [Expand]Docking and Popups
  [Expand]File Management
  [Expand]Data and Image Navigation
  [Expand]Multi-Use Site Controls
  [Expand]Spell Checker
  [Expand]Query Builder
 [Expand]ASP.NET MVC Extensions
 [Expand]Localization
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Selection Modes

One of the major data-processing features adopted from the ASPxGridView allows end-users to select multiple list items within a dropdown grid. The selection behavior is controlled by the ASPxGridLookup.SelectionMode property, which can be set to Single (only one item can be selected within the editor) or Multiple (multiple items can be selected within the editor).

Note

The values contained in the key field (ASPxGridLookup.KeyFieldName) must be unique.

Expanded End User Item Selection

End-users can select items in different ways.

  • By clicking items within a dropdown grid.
    Note that since selection via row clicks is always available for ASPxGridLookup by design, the ASPxGridViewBehaviorSettings.AllowSelectByRowClick property (available via the GridViewProperties.SettingsBehavior property) is not in effect.
  • By clicking item check boxes within the dropdown grid.
    To display check boxes within a dropdown grid, create a specific command column and set its GridViewCommandColumn.ShowSelectCheckbox property to true.
  • By entering tags into the editor's edit box.
    This functionality is controlled by the ASPxGridLookup.TextFormatString and ASPxGridLookup.MultiTextSeparator properties. The TextFormatString property defines the pattern used to format a selected item's text for display within the editor's edit box. The MultiTextSeparator property specifies a value separator. List items (grid rows) that correspond to the tag names entered are selected automatically once the entered value has been submitted (for instance, by pressing the ENTER key or invoking the dropdown window).

Expanded How to Access the Selected Items Programmatically

ASPxGridView behavior varies based on the specified mode.

If the SelectionMode property is set to Single, you should utilize a focused row instead of a selected row. In this case, use the ASPxGridLookup.Value property on the server side and the GetValue/SetValue methods on the client side to get/set the focused row.

If the SelectionMode property is set to Multiple, you can access the selected items' values via the child ASPxGridView control's members.

To learn more, see the following Code Central example: How to use ASPxGridLookup in multiple selection mode as the ASPxGridView editor

Note

When the Multiple selection mode is enabled, incremental filtering does not work.

Expanded Example

The code sample below demonstrates how you can preselect some items in the ASPxGridLookup control by assigning the text of selected values to the ASPxGridLookup.Text property. Note that you should assign it according to the text format that you set in the ASPxGridLookup.TextFormatString property. The text of multiple selected rows is joined in the input using a special separator specified by the ASPxGridLookup.MultiTextSeparator property.

The image below shows the result.

Expanded See Also

Is this topic helpful?​​​​​​​