DataPagerCommandEventArgs.NewStartRowIndex Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Ruft den Index des ersten Datensatzes ab, der auf einer Datenseite angezeigt werden soll, oder legt diesen fest.

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

Eigenschaftswert

Int32

Der Index des ersten Datensatzes, der auf einer Datenseite angezeigt wird.

Beispiele

Das folgende Beispiel zeigt, wie sie die NewStartRowIndex -Eigenschaft verwenden, um den Index des ersten Datensatzes festzulegen, der in einem ListView Steuerelement angezeigt werden soll. Der anzuzeigende Datensatz basiert auf der seitenzahl, die vom Benutzer angegeben wird. 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

In der Regel legen Sie diese Eigenschaft fest, um die aktuell angezeigte Seitenzahl zu ändern.

Wenn Sie einen Wert für die NewStartRowIndex -Eigenschaft festlegen, müssen Sie auch die NewMaximumRows -Eigenschaft festlegen.

Weitere Informationen

• DataPager
• ListView
• TemplatePagerField
• PagerCommand
• OnPagerCommand(DataPagerCommandEventArgs)
• NewMaximumRows
• ListView-Webserversteuerelement