This control provides a simple method for adding paging functionality to your ASP.NET site. The control itself is not "attached" to any data source; instead, that is left up to you, the developer, to take care of.
I currently work for a Web development company (Thap) in Middlesbrough, UK, and was working on a project that required paging in several parts. The project was using
Repeaters for displaying data that the pager would work with, but after unsuccessfully searching for existing controls that meet the project's requirements, I decided to build a paging control myself.
Thap has graciously granted me permission to release the code on to this site under the LGPL license.
Using the Code
Implementing the control is very simple: either include the files in your project, or copy and paste what you need.
To add the control to the page, include the following line at the top:
<%@ Register Src="Pager.ascx" TagName="Pager" TagPrefix="userControl" %>
Now, add this line:
<userControl:Pager ID="Pager" runat="server" Separator=" | " FirstText="First"
PreviousText="<" NextText=">" LastText="Last" PageSize="2" NumberOfPages="3"
ShowGoTo="True" OnChange="Pager_Changed" />
Here is a list of the properties you can set:
Separator: Specify the
string that is to appear between the number links
String to be used for the "first button". Default is "
String to be used for the "previous button". Default is "
String to be used for the "next button". Default is "
String to be used for the "last button". Default is "
PageSize: A handy place to store your page sizes, not used in the code
NumberOfPages: The number of page links to display in between the previous/next links.
ShowGoTo: Displays the
The next thing to do is take care of the code-behind by listening to the
protected void Page_Load(object sender, EventArgs e)
protected void Pager_Changed(object sender, PagerEventArgs e)
private void PopulateDataSource(int page, int pageSize)
var data = new List<String>();
for (int i = 0; i < 20; i++)
data.Skip((page - 1) * pageSize).Take(pageSize);
(data.Count / pageSize) + (data.Count % pageSize > 0 ? 1 : 0);
Pager.TotalPages: Required to correctly display the number links
Pager.GenerateLinks(): Use this to generate the links if changes are made, such as the
currentPageNumber is changed (either by you, or when the
OnChange event is fired)
The event arguments provided are:
First: A boolean indicating whether the "first link" has been clicked
Previous: A boolean indicating whether the "previous link" has been clicked
Next: A boolean indicating whether the "next link" has been clicked
Last: A boolean indicating whether the "last link" has been clicked
PageSize: The page size you set previously
CurrentPageNumber: The number of the current page; this auto increments/decrements when the first/last/previous/next link is clicked
Points of Interest
Currently, the pager is only a user control mainly due to the fact that there was not enough time to bundle it in a library, but this may change in the future.
The numbered links between the
Next links will be generated with the
CurrentPageNumber in the middle. So, if you have set
30, then it will display
And, below is an example of how the control could look:
- 21st October, 2008
- Fixed small non-breaking bug in the code and several mistakes in the article
- 14th August, 2008
- Fixed bug pointed out by Ayyanar
GoTo functionality requested by Mojtaba Vali
- Added a sample page with the control in use
- 7th August, 2008