Skip to main content
.NET 6.0+

DevExpress v24.1 Update — Your Feedback Matters

Our What's New in v24.1 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

Criteria Property in the Application Model

  • 2 minutes to read

The Criteria property of the Application Model‘s IModelListView node allows you to filter List Views using the Model Editor. This means that end-users who have access to the Application Model will be able to change this property. However, there will not be a capability to do this without the Model Editor. This topic explains how to use this property.

Use a List View node’s Criteria property to specify a filtering criteria that will be applied to the current List View. You can use the Filter Builder dialog to visually design the required expression. To invoke this dialog, click the ellipsis button (EllipsisButton) to the right of the property value.

ModelEditor_SpecialEditors_Criteria_2

The value of this property is added to the Criteria collection of the List View’s ListView.CollectionSource. This is performed when the FilterController is activated. So, if you deactivate this Controller, the Criteria property will not be considered for any List View.

This approach can be applied to any List View, whether it is a root, nested in a Lookup Property Editor’s drop-down window, or a Link Action’s pop-up window - any List View that you can find in the Application Model.

Note

In nested List Views, the Criteria is not directly applied to the associated collection. Instead, a separate collection is created, and the criteria are applied to it; the original associated collection is not modified. A nested List View in the Client data access mode with a disabled proxy collection (see XafApplication.DefaultCollectionSourceMode) is an exception. In this instance, the criteria are directly applied to the associated collection.

See Also