DataPagerCommandEventArgs.NewMaximumRows Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.Extensions.dll

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

Int32

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

Im folgenden Beispiel wird gezeigt, wie Sie die NewMaximumRows Eigenschaft verwenden, um die maximale Anzahl von Datensätzen festzulegen, die auf jeder Seite von Daten 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 MaximumRows der Eigenschaft des DataPager Steuerelements festlegen. Sie können über die Eigenschaft auf das DataPager Item Steuerelement zugreifen.

Gilt für

Siehe auch