DataPagerCommandEventArgs.NewStartRowIndex DataPagerCommandEventArgs.NewStartRowIndex DataPagerCommandEventArgs.NewStartRowIndex DataPagerCommandEventArgs.NewStartRowIndex Property

Определение

Возвращает или задает индекс первой записи, которая отображается на странице данных.Gets or sets the index of the first record to display on a page of data.

public:
 property int NewStartRowIndex { int get(); void set(int value); };
public int NewStartRowIndex { get; set; }
member this.NewStartRowIndex : int with get, set
Public Property NewStartRowIndex As Integer

Значение свойства

Индекс первой записи, которая отображается на странице данных.The index of the first record that will be displayed on a page of data.

Примеры

В следующем примере показано, как использовать NewStartRowIndex свойство для задания индекса первой записи, отображаемой ListView в элементе управления.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. Этот пример кода является частью большого примера, DataPagerCommandEventArgs приведенного для класса.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.";
}
Protected Sub TemplatePagerField_OnPagerCommand(ByVal sender As Object, _
  ByVal e As DataPagerCommandEventArgs)
  
  ' Get the new page number 
  Dim PageNumberTextBox As TextBox = _
    CType(e.Item.FindControl("PageNumberTextBox"), TextBox)
  
  Dim newPageNumber As Integer = -1
  Try
    newPageNumber = Convert.ToInt32(PageNumberTextBox.Text.Trim())
  Catch fex As FormatException
    Message.Text = "Invalid page number."
    Return
  Catch oex As OverflowException
    Message.Text = "Invalid page number."
    Return
  End Try
      
  Dim newIndex As Integer = _
    (newPageNumber - 1) * e.Item.Pager.PageSize
  
  'Verify if the new index is valid
  If newIndex >= 0 AndAlso newIndex <= e.TotalRowCount Then
    'Set the new start index and maximum rows
    e.NewStartRowIndex = newIndex
    e.NewMaximumRows = e.Item.Pager.MaximumRows
  Else
    Message.Text = "Invalid page number."
  End If
  
End Sub

Комментарии

Это свойство обычно задается, чтобы изменить номер страницы, отображаемый в данный момент.You usually set this property to change the page number that is currently being displayed.

При установке значения для NewStartRowIndex свойства необходимо также NewMaximumRows задать свойство.When you set a value for the NewStartRowIndex property, you must also set the NewMaximumRows property.

Применяется к

Дополнительно