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.

適用対象

こちらもご覧ください