Skip to main content
.NET 8.0+

Collection Properties

  • 3 minutes to read

XAF applications display collection properties as nested List Views or as Tag Box editors.

Refer to the following topics for information on relationships between entities in code and UI:

Note

Refer to the Property Editors | Collection Properties section in the Feature Center demo installed with XAF to see Collection Property Editors in action. The default location of the application is %PUBLIC%\Documents\DevExpress Demos 25.1\Components\XAF\FeatureCenter.NETFramework.XPO.

Examples

ListPropertyEditor

ASP.NET Core Blazor
XAF ASP.NET Core Blazor ListPropertyEditor, DevExpress
Windows Forms
XAF Windows Forms ListPropertyEditor, DevExpress
ASP.NET Web Forms
XAF ASP.NET Web Forms ListPropertyEditor, DevExpress

The platform-agnostic ListPropertyEditor creates a Template and Frame that contain a List View. This List View uses the ListView.CollectionSource of the PropertyCollectionSource type.

For more information on Templates, Frames, and Views, refer to the UI Element Overview topic.

In the Model Editor, set the IModelMemberViewItem.View property to a custom List View to use this View instead of the default one.

You can hide New, Delete, Link, or Unlink Actions associated with the Property Editor. In the Model Editor, set the List View’s AllowNew, AllowDelete, AllowLink, or AllowUnlink property to false to hide these Actions.

TagBoxPropertyEditor

Important

This editor is currently available as a community technology preview (CTP). We do not recommend that you use it in production projects.

ASP.NET Core Blazor

XAF ASP.NET Core Blazor TagBoxPropertyEditor, DevExpress

Component Model:

  • DevExpress.ExpressApp.Blazor.Components.Models.DxButtonModel
  • DevExpress.ExpressApp.Blazor.Editors.DxTagBoxListModel

Component: DevExpress.ExpressApp.Blazor.Components.TagBoxListComponent – a wrapper that contains the DxTagBox<TData, TValue> editor and DxButton control shipped with the DevExpress ASP.NET Core Blazor Library.

Description:

TagBoxPropertyEditor allows users to select multiple items from its drop-down list. Use this editor as an alternative for large data grids when you want to save space in Detail Forms for collection data. The editor supports CRUD operations, Security System, Application Model options such as AllowEdit or AllowClear, DataSourceXXX filtering attributes, ImmediatePostData, and other standard XAF features.

To edit an item in a pop-up window, users can double-click the tag in the editor.

To access and customize a TagBoxPropertyEditor in XAF applications, create a ViewController that accesses a TagBoxPropertyEditor object and modifies the underlying DxTagBox<TData, TValue> control. For more information about Property Editor customization in Detail Views, refer to the following topic: Access the Settings of a Property Editor in a Detail View.

Windows Forms

XAF Windows Forms TagBoxPropertyEditor, DevExpress

Control: TagBoxListEdit – a descendant of the BaseEdit editor shipped with the XtraEditors Library.

Repository Item: RepositoryItemTokenEdit – a descendant of the XtraEditors Library’s RepositoryItemTokenEdit.

Description:

TagBoxPropertyEditor allows users to select multiple items from its drop-down list. Use this editor as an alternative for large data grids when you want to save space in Detail Forms for collection data. The editor supports CRUD operations, Security System, Application Model options such as AllowEdit or AllowClear, DataSourceXXX filtering attributes, ImmediatePostData, and other standard XAF features.

Users can click the New button to create a new collection item. To clear the editor (remove all selected tags), users can press the Ctrl+Delete key combination. To delete selected tags or delete the last added tag, users can press Backspace. For more information about the available shortcuts, refer to the following topic: Token Edit Control.

See Also