[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications, and Dialogs
  [Collapse]Editors and Simple Controls
    Included Controls and Components
   [Expand]Common Editor Features and Concepts
   [Collapse]Lookup Editors
     Lookup Editors and Main Settings
     Standard Binding (to Simple Data Types)
     Advanced Binding (to Business Objects)
     Using a Dictionary Lookup Data Source
     Combobox Mode - Allow Entering New Values
     Cascading Lookups
    Popup Container Editor
   [Expand]Token Edit Control
   [Expand]Breadcrumb Edit Control
   [Expand]Range Control
   [Expand]Image Slider
    Camera Control
    Templated ListBox Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Gantt Control
  [Expand]Chart Control
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[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]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Lookup Editors

A lookup editor is an editor with an embedded dropdown window, which displays lookup records (the records from which an end-user can select). When a lookup record is selected, the editor's value (the EditValue bindable property) and display text are modified accordingly.

The first thing to do when setting up a lookup editor is assign a lookup data source (a set of lookup records displayed in the dropdown) to the editor. The lookup data source can be a DataTable, List, array of objects or simple data type values, etc. Lookup records must be unique values (in case the data source is an array of simple values) or contain a key field(s) that uniquely identifies each record. This ensures the proper functioning of the mechanism that matches the editor's value with lookup records.

You then usually need to specify a key field that uniquely identifies lookup records (different properties are used in different binding modes) and a field that specifies values displayed in the edit box. You will find more information on setting up lookup editors in the topics that describe various binding modes (see below).

The DevExpress Windows Forms library offers several lookup editors that differ in the way they present the lookup records, and in the functionality they provide. For instance, the LookUpEdit control presents lookup records in a lightweight grid (tabular) format, while the GridLookUpEdit presents lookup records using an embedded feature-rich GridControl. See the following topic to learn more.

Typically, lookup editors are bound to values of simple data types (e.g., integer). However, they can also be bound to business objects. They also support an easy set up when the lookup data source is a Dictionary object. A special combobox mode is tailored to mimic the behavior of the standard ComboBox control, which allows for custom values to be entered. More information can be found in the topics below.

You may want to filter the popup data source of one (secondary) lookup editor based on the value of another (primary) lookup editor. This scenario is covered in the following topic.

Expanded Additional Features

Compared to the standard ComboBox control, lookup editors provide many additional features. Some of them are listed below.

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