PagedControl.ItemsPerPage Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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 Mobile Apps & Sites with ASP.NET.
public:
property int ItemsPerPage { int get(); void set(int value); };
[System.ComponentModel.Bindable(true)]
public int ItemsPerPage { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.ItemsPerPage : int with get, set
Public Property ItemsPerPage As Integer
Property Value
The number of items displayed per page after pagination.
- Attributes
Examples
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"
Namespace="System.Web.UI.MobileControls"
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
List1.Items.Clear();
// 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;
List1.DataBind();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<body>
<mobile:Form id="Form1" runat="server" Paginate="true">
<mobile:List id="List1" runat="server"
ItemCount="200" onLoadItems="LoadNow" />
</mobile:Form>
</body>
</html>
<%@ Page Language="VB"
Inherits="System.Web.UI.MobileControls.MobilePage" %>
<%@ Register TagPrefix="mobile"
Namespace="System.Web.UI.MobileControls"
Assembly="System.Web.Mobile" %>
<script runat="server">
' Called by the List whenever it needs new items
Private Sub LoadNow(ByVal sender As Object, _
ByVal e As LoadItemsEventArgs)
Dim i, j As Integer
i = 0
j = e.ItemIndex
Dim estItemSize As Integer = 110
' Get the optimum page weight for the device
Dim wt As Integer = _
form1.Adapter.Page.Adapter.OptimumPageWeight
' Get the number of items per page
List1.ItemsPerPage = wt / estItemSize
' Clear the current items
List1.Items.Clear()
' Build a section of the array
Dim arr As New ArrayList()
For i = 1 To e.ItemCount
arr.Add(j + i)
Next
' Assign the array to the list
List1.DataSource = arr
List1.DataBind()
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<body>
<mobile:form id="form1" runat="server" Paginate="true">
<mobile:List id="List1" runat="server"
ItemCount="200" onLoadItems="LoadNow"
ItemsPerPage="8" />
</mobile:form>
</body>
</html>
Remarks
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.