DataPagerCommandEventArgs.NewStartRowIndex Property

 

Gets or sets the index of the first record to display on a page of data.

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

public int NewStartRowIndex { get; set; }

Property Value

Type: System.Int32

The index of the first record that will be displayed on a page of data.

You usually set this property to change the page number that is currently being displayed.

When you set a value for the NewStartRowIndex property, you must also set the NewMaximumRows property.

The following example shows how to use the NewStartRowIndex property to set the index of the first record to display in a ListView control. The record to display is based on the page number that is specified by the user. This code example is part of a larger example provided for the DataPagerCommandEventArgs class.

protected void TemplatePagerField_OnPagerCommand(object sender, DataPagerCommandEventArgs e)
{     
    // Get the new page number 
    TextBox PageNumberTextBox = (TextBox)e.Item.FindControl("PageNumberTextBox");
    int newPageNumber = -1;
    try
    {
      newPageNumber = Convert.ToInt32(PageNumberTextBox.Text.Trim());
    }
    catch (FormatException)
    {
      Message.Text = "Invalid page number.";
      return;
    }
    catch (OverflowException)
    {
      Message.Text = "Invalid page number.";
      return;
    }

    int newIndex = (newPageNumber - 1) * e.Item.Pager.PageSize;
    //Verify if the new index is valid
    if (newIndex >= 0 && newIndex <= e.TotalRowCount)
    {
      //Set the new start index and maximum rows
      e.NewStartRowIndex = newIndex;
      e.NewMaximumRows = e.Item.Pager.MaximumRows;
    }
    else
      Message.Text = "Invalid page number.";
}

.NET Framework
Available since 3.5
Return to top
Show: