Freigeben über


DataPagerCommandEventArgs.NewMaximumRows Eigenschaft

Definition

Ruft die maximale Anzahl der Datensätze ab, die auf den einzelnen Datenseiten angezeigt werden sollen, oder legt diese fest.

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

Eigenschaftswert

Die maximale Anzahl der Datensätze, die auf einer einzelnen Datenseite angezeigt werden sollen. Der Standardwert ist -1 und bedeutet, dass diese Eigenschaft nicht festgelegt wurde.

Beispiele

Das folgende Beispiel zeigt, wie die NewMaximumRows -Eigenschaft verwendet wird, um die maximale Anzahl von Datensätzen festzulegen, die auf jeder Datenseite angezeigt werden sollen. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die DataPagerCommandEventArgs-Klasse bereitgestellt wird.

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

Hinweise

Wenn Sie einen Wert für die NewStartRowIndex -Eigenschaft festlegen, müssen Sie auch die NewMaximumRows -Eigenschaft festlegen. Wenn Sie den aktuellen Wert nicht ändern möchten, können Sie die NewMaximumRows -Eigenschaft auf den Wert der MaximumRows -Eigenschaft des DataPager Steuerelements festlegen. Sie können über die -Eigenschaft auf das DataPagerItem Steuerelement zugreifen.

Gilt für:

Weitere Informationen