VirtualServerModeSource.MoreRows Event
Fires when a bound grid control asks the data source for a new batch of rows.
Namespace: DevExpress.Data
Assembly: DevExpress.Data.v19.1.dll
Declaration
Event Data
The MoreRows event's data class is VirtualServerModeRowsEventArgs. The following properties provide information specific to this event:
Property | Description |
---|---|
CancellationToken | Gets a token that allows you to respond to a task cancellation request invoked by the grid control. |
ConfigurationInfo | Gets information on the grid’s current sorting, filtering and summary configuration. |
CurrentRowCount | Gets the count of rows currently loaded to the grid. |
RowsTask | Gets or sets the task that returns requested rows. |
UserData |
Read this parameter to get custom data passed from the previously called Task or ConfigurationChanged event handler. When handling the VirtualServerModeSource.ConfigurationChanged event, set the UserData event parameter to pass custom data to a subsequent VirtualServerModeSource.MoreRows event handler (unless you specify the RowsTask event parameter). |
Remarks
To provide a batch of rows, create a Task that returns requested rows and assign it to the RowTask event parameter.
Tip
A Task typically executes asynchronously. To return a batch of rows synchronously, create the task with the Task.FromResult method (available in .NET Framework 4.5+).
The VirtualServerModeSource supports two data supplying scenarios:
- Handle the VirtualServerModeSource.ConfigurationChanged event to perform a source initialization and supply an initial batch of rows. Handle the MoreRows event to supply subsequent batches of rows (when required).
- Handle the VirtualServerModeSource.ConfigurationChanged event to perform a source initialization (when required). Handle the MoreRows event to supply all (initial and subsequent) batches of rows. If you handle the VirtualServerModeSource.ConfigurationChanged event, this event’s RowTask parameter should be left unassigned.