ASPxGridViewPagerSettings.Mode Property

Specifies whether the Grid View control splits its content across multiple pages.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v23.2.dll

NuGet Package: DevExpress.Web

Declaration

C#

[DefaultValue(GridViewPagerMode.ShowPager)]
public GridViewPagerMode Mode { get; set; }

VB.NET

<DefaultValue(GridViewPagerMode.ShowPager)>
Public Property Mode As GridViewPagerMode

Property Value

Type	Default	Description
GridViewPagerMode	ShowPager	An enumeration value.

Available values:

Name	Description
ShowAllRecords	Disables page-mode navigation.
ShowPager	The ASPxGridView automatically splits content (rows) across multiple pages and provides end-users with an embedded page navigation UI - Pager. The maximum number of rows displayed on a page is specified by the ASPxGridViewPagerSettings.PageSize property.
EndlessPaging	The endless paging is enabled.

Property Paths

You can access this nested property as listed below:

Library	Object Type	Path to Mode
ASP.NET MVC Extensions	GridViewSettings	.SettingsPager .Mode
	MVCxGridViewProperties	.SettingsPager .Mode
ASP.NET Web Forms Controls	ASPxGridView	.SettingsPager .Mode
	GridViewProperties	.SettingsPager .Mode

Remarks

The Grid View control automatically splits its content across multiple pages. The built-in pager allows users to navigate through the control’s data. Refer to the following topic for more information: Data Paging.

Set the Mode property to ShowAllRecords to display all grid rows on one page. To enable endless paging mode, set the Mode property to EndlessPaging. Note that you cannot enable or disable the endless paging mode on a callback. Refer to one of the following topics for more information about endless paging mode and its limitations:

• ASPxGridView - Endless Paging
• MVCxGridView - Endless Paging

The example below demonstrates how to enable endless page mode:

ASP.NET Web Forms

<dx:ASPxGridView ID="GridView" runat="server" DataSourceID="DataSource" KeyFieldName="OrderID">
    <Columns>
        <!-- ... -->
    </Columns>
    <SettingsPager Mode="EndlessPaging"/>
</dx:ASPxGridView>

ASP.NET MVC

@Html.DevExpress().GridView(settings => {
    settings.Name = "gridView";
    settings.KeyFieldName = "OrderID";
    settings.Columns.Add(c => {
        <!-- ... -->
    });
    settings.SettingsPager.Mode = GridViewPagerMode.EndlessPaging;
}).Bind(Model).GetHtml()

Online Demos

• ASPxGridView - Pager Settings
• ASPxGridView - SEO Friendly Paging
• ASPxGridView - Endless Paging
• MVCxGridView - Paging
• MVCxGridView - SEO Friendly Paging
• MVCxGridView - Endless Paging