Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]Prerequisites
 [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]Card View
  [Collapse]Vertical Grid
    Overview - VerticalGrid
    Main Features
   [Collapse]Concepts
    [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
      Selection
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]HTML Editor
  [Expand]Image and Data Browsing
  [Expand]Docking and Popups
  [Expand]Navigation and Layout Extensions
  [Expand]File Management
  [Expand]Multi-Use Site Extensions
  [Expand]Charts
  [Expand]Pivot Grid
  [Expand]Scheduler
  [Expand]Tree List
  [Expand]Data Editor Extensions
  [Expand]Report Extensions
  [Expand]SpellChecker
 [Expand]Localization
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

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.

Example

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.

Example

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.

Example

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.

How would you rate this topic?​​​​​​​