[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]ASP.NET WebForms Controls
 [Collapse]ASP.NET MVC Extensions
  [Expand]Product Information
  [Expand]Getting Started
  [Expand]Common Concepts
  [Expand]Grid View
  [Expand]Tree List
  [Expand]Card View
  [Expand]Pivot Grid
  [Expand]Rich Text Editor
  [Expand]Site Navigation and Layout
  [Expand]HTML Editor
  [Collapse]Vertical Grid
    Overview - VerticalGrid
    Main Features
    [Expand]Binding to Data
    [Expand]Data Representation Basics
    [Expand]Data Editing and Validation
    [Collapse]Focus and Navigation
     [Collapse]Paging and Scrolling
       Data Paging
       Horizontal Scrolling
       Vertical Scrolling
  [Expand]Data Editors Extensions
  [Expand]Docking and Popups
  [Expand]File Management
  [Expand]Data and Image Navigation
  [Expand]Multi-Use Site Extensions
  [Expand]Query Builder
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Data Paging

This topic describes the concept of data paging, including an overview of the paging functionality, appearance customization, as well as how to navigate pages on the server and client sides.

Expanded Data Paging Overview

By default, the VerticalGrid automatically splits content across multiple pages and provides end-users with an embedded page navigation UI - Pager.

The built-in pager enables end-users to navigate through VerticalGrid data. It consists of the following navigation buttons: Next, Last, Previous, First and All. It also includes an indicator that displays the current page number and the total number of pages, and a page size item allowing you to specify the maximum number of rows that can be displayed within a page. To access and customize pager settings, use the VerticalGridSettings.SettingsPager property.

To disable page navigation and display all rows within the grid, set the ASPxVerticalGridPagerSettings.Mode (through VerticalGridSettings.SettingsPager.Mode) property to VerticalGridPagerMode.ShowAllRecords.

Expanded Appearance Customization

The pager can be displayed above or below the rows, or on both sides. Use the ASPxGridPagerSettings.Position (through VerticalGridSettings.SettingsPager.Position) property to specify the pager's position within the VerticalGrid.

The maximum number of rows that can be displayed within a page can be accessed using the ASPxVerticalGridPagerSettings.PageSize (using VerticalGridSettings.SettingsPager.PageSize) property.

The VerticalGrid's look and feel can be customized with Templates. A template is a set of HTML elements and ASP.NET MVC extensions that define the layout for a particular element within the ASP.NET MVC extension (e.g., a pager). When the extension runs in the web page, template content is rendered in place of the default HTML for the extension.


The code sample below demonstrates how to implement a custom pager using templates.

Partial View code:

The image below illustrates the result.

Expanded Page Navigation on the Server Side

The active page is determined by the ASPxGridBase.PageIndex (through MVCxVerticalGrid.PageIndex) property. Use this property to switch between pages in code. The total number of pages can be obtained using the ASPxGridBase.PageCount (through MVCxVerticalGrid.PageCount) property.


The code sample below demonstrates how to define the initially displayed page on the first start.

Partial View code:

The image below illustrates the result.

Expanded Page Navigation on the Client Side

The VerticalGrid provides a client-side API that enables you to navigate a user to a specific page. The table below lists the available navigation-related methods.

Method Description
ASPxClientVerticalGrid.GotoPage Selects the specified page.
ASPxClientVerticalGrid.NextPage Activates the next page.
ASPxClientVerticalGrid.PrevPage Activates the previous page.


The example below demonstrates how to enable an end-user to navigate to any VerticalGrid page without clicking the pager. In this example, an end-user can use the SpinEdit editor to specify (by entering the number manually or by clicking the spin buttons) the page number to which the grid should be paged.

View Code:

Partial View code:

The image below illustrates the result.

Is this topic helpful?​​​​​​​