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 () to the right of the property value.
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.
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.