LookupEditorMode Enum

Specifies the mode of a business class property’s Lookup Property Editor.

Namespace: DevExpress.Persistent.Base

Assembly: DevExpress.ExpressApp.v26.1.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#

public enum LookupEditorMode

VB.NET

Public Enum LookupEditorMode

Members

Name	Description
Auto	Blazor: Equals the AllItems value. WinForms: If the Lookup Property Editor’s data source collection contains fewer objects than LookupSmallCollectionItemCount, the editor’s behavior equals the AllItems; otherwise the behavior equals Search.
AllItems	All objects are loaded to the Lookup Property Editor’s data source. The Search feature is disabled.
Search	The Lookup Property Editor’s data source is empty. The Search feature is available.
AllItemsWithSearch	All objects are loaded to the Lookup Property Editor’s data source. The Search feature is available.

Related API Members

The following properties accept/return LookupEditorMode values:

• IModelClass.DefaultLookupEditorMode
• IModelCommonMemberViewItem.LookupEditorMode
• LookupEditorModeAttribute.Mode

Remarks

LookupEditorMode enumeration specifies several aspects of Lookup Property Editor behavior:

• Data loading mode
• Text search capabilities
• Editor UI type

Specify Lookup Property Editor Mode in the Model Editor

IModelClass.DefaultLookupEditorMode

Specifies the default mode for all Lookup Property Editors bound to reference properties of the current type (BOModel | <Class>).

IModelCommonMemberViewItem.LookupEditorMode

Specifies the mode of the current Lookup Property Editor (BOModel | <Class> | <Class>_DetailView | Items | <Item>).

Specify Lookup Property Editor Mode in Code

Apply the LookupEditorModeAttribute to a reference property to specify the editor mode:

File: SolutionName.Module/BusinessObjects/Employee.cs

C#

using DevExpress.Persistent.Base;

namespace SolutionName.Module.BusinessObjects;

public class Employee : BaseObject {
    // ...
    [LookupEditorMode(LookupEditorMode.AllItemsWithSearch)]
    public Department Department {
      // ...
    }
  }

For more information about search capabilities in LookupPropertyEditor, its data retrieval modes and corresponding UI options, refer to the following topic: How to: Add Search Action to Lookup Property Editors and Link Pop-up Windows.