Back to Devexpress

ASPxGridViewPagerSettings.Mode Property

aspnet-devexpress-dot-web-dot-aspxgridviewpagersettings.md

latest4.9 KB
Original Source

ASPxGridViewPagerSettings.Mode Property

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

Namespace : DevExpress.Web

Assembly : DevExpress.Web.v25.2.dll

NuGet Package : DevExpress.Web

Declaration

csharp
[DefaultValue(GridViewPagerMode.ShowPager)]
public GridViewPagerMode Mode { get; set; }
vb
<DefaultValue(GridViewPagerMode.ShowPager)>
Public Property Mode As GridViewPagerMode

Property Value

TypeDefaultDescription
GridViewPagerModeShowPager

An enumeration value.

|

Available values:

NameDescription
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:

LibraryObject TypePath to Mode
ASP.NET MVC ExtensionsGridViewSettings

.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:

The example below demonstrates how to enable endless page mode:

aspx
<dx:ASPxGridView ID="GridView" runat="server" DataSourceID="DataSource" KeyFieldName="OrderID">
    <Columns>
        <!-- ... -->
    </Columns>
    <SettingsPager Mode="EndlessPaging"/>
</dx:ASPxGridView>
razor
@Html.DevExpress().GridView(settings => {
    settings.Name = "gridView";
    settings.KeyFieldName = "OrderID";
    settings.Columns.Add(c => {
        <!-- ... -->
    });
    settings.SettingsPager.Mode = GridViewPagerMode.EndlessPaging;
}).Bind(Model).GetHtml()

Online Demos

See Also

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

ASPxGridViewPagerSettings Class

ASPxGridViewPagerSettings Members

DevExpress.Web Namespace