DataPagerCommandEventArgs.NewMaximumRows 屬性

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.Extensions.dll

取得或設定每個資料頁上顯示的最大資料錄筆數。

public:
 property int NewMaximumRows { int get(); void set(int value); };

public int NewMaximumRows { get; set; }

member this.NewMaximumRows : int with get, set

Public Property NewMaximumRows As Integer

屬性值

Int32

每個資料頁上顯示的最大資料錄筆數。 預設值為 -1，表示這個屬性未設定。

範例

下列範例示範如何使用 NewMaximumRows 屬性來設定要顯示在每一頁數據上的記錄數目上限。 此程式碼範例是針對 類別提供的較大範例的 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 屬性。 如果您不想變更目前的值，您可以將 屬性設定 NewMaximumRows 為 MaximumRows 控制項的 DataPager 屬性值。 您可以透過 Item 屬性存取 DataPager 控制項。

另請參閱

• DataPager
• ListView
• TemplatePagerField
• PagerCommand
• OnPagerCommand(DataPagerCommandEventArgs)
• ListView 網頁伺服器控制項