DataPagerCommandEventArgs.NewStartRowIndex プロパティ

定義

名前空間:

System.Web.UI.WebControls

アセンブリ:

System.Web.Extensions.dll

データ ページに表示される最初のレコードのインデックスを取得または設定します。

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

プロパティ値

Int32

データ ページに表示される最初のレコードのインデックス。

例

次の例は、プロパティを NewStartRowIndex 使用して、コントロールに表示する最初のレコードのインデックスを設定する方法を ListView 示しています。 表示するレコードは、ユーザーが指定したページ番号に基づいています。 このコード例は、DataPagerCommandEventArgs クラスのために提供されている大規模な例の一部です。

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

注釈

通常、このプロパティを設定して、現在表示されているページ番号を変更します。

プロパティの値 NewStartRowIndex を設定する場合は、プロパティも設定する NewMaximumRows 必要があります。

こちらもご覧ください

• DataPager
• ListView
• TemplatePagerField
• PagerCommand
• OnPagerCommand(DataPagerCommandEventArgs)
• NewMaximumRows
• ListView Web サーバー コントロール