# Virtual paging: large lists with virtual scrolling Data loads **the usual way**: DA query → service returns `List` → controller endpoint. Only two common pieces are added: | Piece | File | What it does | |---|---|---| | `VirtualPaging.Page(...)` | `HRM.DA/Service/VirtualPaging/VirtualPaging.cs` | Keeps the list in memory for a few minutes, then search, sort, 100 rows at a time and the total count | | `` | `ClientApp/src/app/custom-components/virtual-grid/` (`VirtualGridModule`) | Virtual scrolling, search box, total, Export to Excel | `VirtualPageRequest` / `VirtualPageResult` (`HRM.BO/VirtualPaging/VirtualPaging.cs`) are shared by every page, so a page never needs its own request class. ## A new page: 2 steps **1. Endpoint** in the module's own controller, calling the existing service: ```csharp [HttpPost("getDiscontinueEmployeePage")] public ActionResult GetDiscontinueEmployeePage(VirtualPageRequest request) { try { CurrentUser currentUser = CurrentUser.GetCurrentUser(HttpContext.User); DateTime fromDate = request.GetDate("fromDate", "From Date"); // the page's own filters DateTime toDate = request.GetDate("toDate", "To Date"); return Ok(VirtualPaging.Page(request, currentUser, () => _EmployeeService.GetDiscontinuedEmployeeDetails(fromDate, toDate, currentUser.PayrollTypeID ?? 0))); } catch (Exception ex) { return StatusCode(StatusCodes.Status500InternalServerError, ex.Message); } } ``` Read filters with `request.GetDate(name)`, `request.GetInt(name)` or `request.GetString(name)` (null when not sent). **2. Screen**: import `VirtualGridModule`, then: ```html ``` ```ts columns: VirtualGridColumn[] = [ { field: 'employeeNo', title: 'Employee No', width: 110 }, { field: 'joiningDate', title: 'Joining Date', type: 'date' }, { field: 'grossSalary', title: 'Gross Salary', type: 'money' }, ]; preview() { this.grid.load({ fromDate: this.fromDate, toDate: this.toDate }); // any filters; Dates are sent as yyyy-MM-dd } ``` `field` is the property name of the BO (camelCase). Column `type`: `text` (default), `number`, `money` (1,234.56), `date` (dd MMM yyyy), `datetime`. `sortable: false` turns sorting off for a column. That is all. No registry, no extra service, no extra Angular service. ## How it runs 1. **Preview** → `grid.load(filters)` → the endpoint with `refresh: true` → the service is called once, the list is kept in server memory (per user + endpoint + filters, 10 min since last use, 30 min at most) → the first 100 rows and the total go back. 2. **Scroll / sort / search** → same endpoint, `refresh: false` → answered from the kept list. 3. **Export to Excel** → same endpoint with `take: 0` → every matching row → Kendo builds the `.xlsx`. The browser shows ~100 rows at a time, however long the list is. ## Rules - The service must not run one query per row; load lookups once (see `GetDiscontinuedEmployeeDetails`). - Search looks in the text the grid shows (dates `dd MMM yyyy`, money `1,234.56`). - Authorization is menu-driven in this app: put any extra check the page needs in its endpoint.