The System.Web.UI.WebControls.DetailsView control has built-in paging capabilities, which allow a user to navigate to a different record in the data source.

The System.Web.UI.WebControls.DetailsView control can perform both user interface (UI) and data source paging. The UI paging feature can be used with any data source object that supports the ICollection interface. For each paging operation, the System.Web.UI.WebControls.DetailsView control queries the data source for the entire data collection and selects the row to display, essentially discarding the remaining data.

If a data source implements System.Web.UI.DataSourceView and the System.Web.UI.DataSourceView.CanPage property returns true, the System.Web.UI.WebControls.DetailsView control will use data source paging instead of UI paging. In this case, the System.Web.UI.WebControls.DetailsView control will query for only the row needed for each paging operation. Thus, data source paging is more efficient than UI paging. Only the System.Web.UI.WebControls.ObjectDataSourceView object supports data source paging without modification.

To enable the paging feature, set the DetailsView.AllowPaging property to true. You can determine the total number of items in the underlying data source by using the DetailsView.PageCount property. To determine the index of the currently displayed item, use the DetailsView.PageIndex property.

When paging is enabled, an additional row called the pager row is automatically displayed in the System.Web.UI.WebControls.DetailsView control. The pager row contains the page navigation controls and can be displayed at the top, bottom, or both the top and bottom of the control. The pager row has two built-in pager display modes: numbered pages and next and previous page links (default). The numbered pages mode displays links for the individual pages, allowing the user to navigate to a specific page. The next and previous links mode displays controls that allow the user to navigate to the next or the previous page.

You can control the settings of the pager row (such as the pager display mode, the number of page links to display at a time, and the pager control's text label) by using the DetailsView.PagerSettings property. To control the appearance of the pager row (including its background color, font color, and position), use the DetailsView.PagerStyle property. The System.Web.UI.WebControls.DetailsView control also allows you to define a custom template for the pager row. For more information on creating a custom pager row template, see DetailsView.PagerTemplate.

The System.Web.UI.WebControls.DetailsView control provides several events that you can use to perform a custom action when paging occurs. The following table lists the available events.

DetailsView.PageIndexChanged	Occurs when one of the pager buttons is clicked, but after the System.Web.UI.WebControls.DetailsView control handles the paging operation. This event is commonly used when you need to perform a task after the user navigates to a different record in the control.
DetailsView.PageIndexChanging	Occurs when one of the pager buttons is clicked, but before the System.Web.UI.WebControls.DetailsView control handles the paging operation. This event is often used to cancel the paging operation.

The value of DetailsView.AllowPaging is stored in view state.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)
Assembly Versions: 2.0.0.0
Since: .NET 2.0