DataGrid::AllowCustomPaging Property

 

Gets or sets a value that indicates whether custom paging is enabled.

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

public:
property bool AllowCustomPaging {
	virtual bool get();
	virtual void set(bool value);
}

Property Value

Type: System::Boolean

true if custom paging is enabled; otherwise, false. The default value is false.

Paging allows you to display the contents of the DataGrid control in page segments. The number of items on a page is determined by the PageSize property. If no value is specified for the PageSize property, the DataGrid will display 10 items on a page.

Normally, a data source that contains every row in the DataGrid control is loaded every time the DataGrid control moves to a different page. This can consume a lot of resources when the data source is very large. Custom paging allows you to load just the segment of data needed to display a single page.

To enable custom paging, set both the AllowPaging and AllowCustomPaging properties to true. Next, provide code to handle the PageIndexChanged event.

The typical logic for the PageIndexChanged event handler is to first set the CurrentPageIndex property to the index of the page you want to display.

System_CAPS_noteNote

The event handler receives a DataGridPageChangedEventArgs object as a parameter. You can use the NewPageIndex property of this parameter to determine the index of the page selected by the user from the page selection elements of the DataGrid control.

Next, create a data source that contains the data to display on a single page and then use the DataBind method to bind the data to the DataGrid control.

System_CAPS_noteNote

Because only a segment of the data is loaded, you must set the VirtualItemCount property to the total number of items in the DataGrid control. This allows the control to determine the total number of pages needed to display every item in the DataGrid control. This property is normally programmatically set once the total number of items in the DataGrid control is determined.

When paging is enabled with the AllowCustomPaging property is set to false, the DataGrid control assumes that the data source contains all the items to be displayed. The DataGrid control calculates the indexes of the items on the displayed page based on the page index, specified by the CurrentPageIndex property, and the number of items on a page, specified by the PageSize property.

When the AllowCustomPaging property is set to true, the DataGrid control assumes that the data source only contains the items as determined by the VirtualItemCount property. All items up to the number of items specified by the PageSize property are displayed.

The following code example demonstrates how to use the AllowCustomPaging property to enable custom paging.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 1.1
Return to top
Show: