.NET MAUI TreeDataGrid Load On Demand

The Telerik UI for .NET MAUI TreeDataGrid enables you to improve its performance and save computing resources, by loading data in the RadTreeDataGrid when the control is already displayed.

To load a large data set on mobile devices, you can use incremental data loading at the time when the user required the items to be visualized.

Modes

The DataGrid provides the following data-loading modes, which are present in the LoadOnDemandMode enumeration:

• Automatic—The load-on-demand mechanism is activated when you scroll down near the last item present in the viewport.

  To control when the items will start loading, set the LoadOnDemandBufferItemsCount property. It indicates at which point the additional items will start loading. For example, setting it to 20 will cause the new items to be loaded when you have scrolled the DataGrid, so that only 20 of the originally loaded items are left below.

• Manual—A Load More button is present at the bottom of the DataGrid. Clicking it will load additional items based on the approach you have chosen for loading the items (through the event, the command, or the collection).

When the LoadOnDemandMode is Automatic and grouping applies to the control, the LoadOnDemandMode transforms to Manual.

Approaches

The DataGrid supports the following options for using its load-on-demand feature, depending on your application requirements:

• Using the LoadOnDemand collection
• Using the LoadOnDemand event
• Using the LoadMoreData command

LoadOnDemand Collection

To use this approach, you have to feed the RadDataGrid with a collection of type LoadOnDemandCollection. LoadOnDemandCollection is a generic type, so you need to point the type of objects it will contain. The type extends the ObservableCollection<T> class and expects a Func<CancellationToken, IEnumerable> in the constructor.

LoadOnDemand Event

You can load new items by utilizing the LoadOnDemand event. The event uses LoadOnDemandEventArgs arguments through which you need to indicate when the data is loaded by setting the IsDataLoaded(bool) property.

LoadMoreData Command

The LoadMoreData command is another alternative which you can use and which is suitable for MVVM scenarios.

Invoking the ShowLoadOnDemandLoadingIndicator and HideLoadOnDemandLoadingIndicators is a notable part as without calling these methods, the BusyIndicator used for the functionality will not be visualized.

Styling

Besides the different approaches for loading the data, the DataGrid exposes several mechanisms related to the styling of the functionality which you can use according to the approach you have chosen.

Load-More-Button Row

The LoadOnDemandRowStyle property can be used to style the appearance of the row that contains the Load More button when the LoadOnDemandMode is Manual.

The custom style is of type Style with target type DataGridLoadOnDemandRowAppearance:

Load-More-Button Row Template

The LoadOnDemandRowTemplate property can be used to set the template of the row that contains the Load More button when the LoadOnDemandMode is Manual.

For runnable examples with the TreeDataGrid Load On Demand options, see the SDKBrowser Demo Application and go to DataGrid > Load On Demand category. Replace the examples with TreeDataGrid and set a ViewModel and Data models with a hierarchical data structure.

Additional Resources

• .NET MAUI TreeDataGrid Product Page
• .NET MAUI TreeDataGrid Forum Page
• Telerik .NET MAUI Blogs
• Telerik .NET MAUI Roadmap

See Also

• Sorting .NET MAUI TreeDataGrid Records
• Filtering .NET MAUI TreeDataGrid Records