DataPagerCommandEventArgs.NewMaximumRows 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得或設定每個資料頁上顯示的最大資料錄筆數。
public:
property int NewMaximumRows { int get(); void set(int value); };public int NewMaximumRows { get; set; }member this.NewMaximumRows : int with get, setPublic Property NewMaximumRows As Integer屬性值
每個資料頁上顯示的最大資料錄筆數。 預設值為 -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控制項。
