IModelListView.DataAccessMode Property
Specifies the mode used to access the collection of business objects displayed in the current List View.
Namespace: DevExpress.ExpressApp.Model
Assembly: DevExpress.ExpressApp.v19.1.dll
Declaration
[TypeConverter(typeof(DataAccessModeConverter))]
CollectionSourceDataAccessMode DataAccessMode { get; set; }Property Value
| Type | Description |
|---|---|
| CollectionSourceDataAccessMode | A CollectionSourceDataAccessMode enumeration value that specifies the mode used to access the collection of business objects in the current List View. |
Available values:
| Name | Description |
|---|---|
| Client | The entire record set required for the current List View is loaded into memory. All the data processing takes place on the client side. |
| Server | Data is requested from a data store in small portions that should currently be displayed. All data-aware operations are performed on the data server side. |
| DataView | A lightweight read-only list of data records (EFDataView or XPView) is retrieved without loading complete persistent objects. |
| InstantFeedback | A List View’s control continues responding to a user’s actions while the data is being retrieved in a background thread (see Instant Feedback Mode). |
Remarks
This property value is passed to the DataAccessMode property of the current List View’s Collection Source. You can change this property value in the Model Editor.
Detailed descriptions of the available data access modes are provided in the following topics.
Modes that are not compatible with the current List Editor (specified using the IModelListView.EditorType property) are hidden from the combo box. If you use a custom List Editor, you can specify supported modes using the static DataAccessModeHelper.RegisterEditorSupportedModes method. You can call this method from any code that is executed at design time prior to loading the Model Editor (e.g., from the module’s constructor). Pass the List Editor type and the list of it’s supported modes to this method. By default, all modes are available for a custom List Editor.
The default data access mode is Client. You can change the default mode for all root List Views and manually created nested List Views globally, using the IModelOptions.DataAccessMode property of the Options node in the Model Editor. For instance, when this property is set to Server, all List Views, except for the autogenerated nested List Views, have their DataAccessMode property set to Server as well.
Note
For List View variants, the root varied View and each variant View can have individual DataAccessMode property values. When the end user switches to a different View Variant, XAF ignores the target View’s DataAccessMode and uses the root View’s value instead. In some scenarios, the View Variant’s List Editor does not support the root View’s DataAccessMode value. In this case, XAF uses the DataAccessMode value from that View Variant’s IModelListView node.
When the View Variants are displayed in Navigation (see View Variants Module), XAF displays the variant Views using their DataAccessMode setting, instead of the root View’s value.