DataPagerCommandEventArgs.NewStartRowIndex Propriété

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Obtient ou définit l'index du premier enregistrement à afficher dans une page de données.

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

Valeur de propriété

Int32

Index du premier enregistrement à afficher dans une page de données.

Exemples

L’exemple suivant montre comment utiliser la NewStartRowIndex propriété pour définir l’index du premier enregistrement à afficher dans un ListView contrôle. L’enregistrement à afficher est basé sur le numéro de page spécifié par l’utilisateur. Cet exemple de code fait partie d’un exemple plus grand fourni pour la DataPagerCommandEventArgs classe .

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

Remarques

Vous définissez généralement cette propriété pour modifier le numéro de page actuellement affiché.

Lorsque vous définissez une valeur pour la NewStartRowIndex propriété, vous devez également définir la NewMaximumRows propriété .

Voir aussi

• DataPager
• ListView
• TemplatePagerField
• PagerCommand
• OnPagerCommand(DataPagerCommandEventArgs)
• NewMaximumRows
• Contrôle serveur Web ListView