PagedControl.ItemsPerPage Property


Gets or sets the number of items displayed per page after pagination. This API is obsolete. For information about how to develop ASP.NET mobile applications, see the Web site.

Namespace:   System.Web.UI.MobileControls
Assembly:  System.Web.Mobile (in System.Web.Mobile.dll)

public int ItemsPerPage { get; set; }

Property Value

Type: System.Int32

The number of items displayed per page after pagination.

If zero, pagination is not affected by this property. If nonzero, overrides items displayed per page when the form is paginated. The default value is zero.

Mobile controls that support internal pagination also provide a feature called custom pagination. Normally, such controls require you to provide all the data that they can display. Developers specify the total number of items that are in the list in the ItemCount property. The ItemsPerPage property specifies how many items the control displays per page.

The following code example shows how to use the ItemsPerPage property to render eight items of a 200-item list per page.

<%@ Page Language="C#" 
    Inherits="System.Web.UI.MobileControls.MobilePage" %>
<%@ Register TagPrefix="mobile" 
    Assembly="System.Web.Mobile" %>

<script runat="server">
    // Called by the List whenever it needs new items
    private void LoadNow(object sender, LoadItemsEventArgs e)
        int j = e.ItemIndex;
        int estItemSize = 110;

        // Get the optimum page weight for the device
        int wt = Form1.Adapter.Page.Adapter.OptimumPageWeight;
        // Get the number of items per page
        List1.ItemsPerPage = wt / estItemSize;

        // Clear the current items

        // Build a section of the array
        ArrayList arr= new ArrayList();
        for (int i = 1; i <= e.ItemCount; i++)
            int v = i + j;
            arr.Add((v.ToString() + " List Item"));

        // Assign the array to the list
        List1.DataSource = arr;

<html xmlns="" >
    <mobile:Form id="Form1" runat="server" Paginate="true">
        <mobile:List id="List1" runat="server" 
            ItemCount="200" onLoadItems="LoadNow" />

.NET Framework
Available since 1.1

PagedControl Class
System.Web.UI.MobileControls Namespace
Pagination Support
Working With Deck Size Limits

Return to top