ASPxGridViewPagerSettings.Mode Property

Gets or sets whether page-mode navigation is enabled.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v19.2.dll

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**	A GridViewPagerMode enumeration value that specifies whether page-mode navigation is enabled.

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 Controls and MVC Extensions	ASPxGridView	.SettingsPager.Mode
	GridViewProperties	.SettingsPager.Mode
	GridViewSettings	.SettingsPager.Mode
	GridViewSettings<RowType>	.SettingsPager.Mode
	MVCxGridView	.SettingsPager.Mode
	MVCxGridViewProperties	.SettingsPager.Mode
ASP.NET Bootstrap Controls	BootstrapGridView	.SettingsPager.Mode

Remarks

To enable page-mode navigation, set the Mode property to GridViewPagerMode.ShowPager. To display all rows within a grid, set this property to GridViewPagerMode.ShowAllRecords. To enable endless paging mode, set the Mode property value to GridViewPagerMode.EndlessPaging.

To learn more, see Data Paging.

Note

• The endless paging mode cannot be enabled or disabled on a callback.
• Endless paging is not supported when the MVC GridView extension is bound to custom data.

Online Demos

• ASPxGridView - Pager Settings (WebForms)

• ASPxGridView - SEO Friendly Paging (WebForms)

• ASPxGridView - Endless Paging (WebForms)

• GridView - Paging (MVC)

• GridView - SEO Friendly Paging (MVC)

• GridView - Endless Paging (MVC)

Example

WebForms approach:

ASPX

<dx:ASPxGridView ID="GridView" runat="server" DataSourceID="OrdersDataSource" Width="100%" KeyFieldName="OrderID">
    <Columns>
    ...
    </Columns>
    <Settings ShowGroupPanel="true" VerticalScrollBarMode="Visible" VerticalScrollableHeight="400" />
    <SettingsPager Mode="EndlessPaging" PageSize="20" />
</dx:ASPxGridView>

MVC approach:

Razor(View)

@Html.DevExpress().GridView(settings => {
    settings.Name = "gridView";
    ...
    settings.Settings.VerticalScrollBarMode = ScrollBarMode.Visible;
    settings.Settings.VerticalScrollableHeight = 400;

    settings.SettingsPager.Mode = GridViewPagerMode.EndlessPaging;
    settings.SettingsPager.PageSize = 20;
    ...
}).Bind(Model).GetHtml()

Online Example

• GridView - How to create a custom “Select Page Size” element with the “Show All Records” feature (MVC)