DataPagerCommandEventArgs.NewMaximumRows Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.Extensions.dll

Obtém ou define o número máximo de registos a serem exibidos em cada página de dados.

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

Valor de Propriedade

Int32

O número máximo de registos a mostrar em cada página de dados. O padrão é -1, o que indica que esta propriedade não está definida.

Exemplos

O exemplo seguinte mostra como usar a NewMaximumRows propriedade para definir o número máximo de registos a exibir em cada página de dados. Este exemplo de código faz parte de um exemplo maior fornecido para a 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

Observações

Quando define um valor para a NewStartRowIndex propriedade, também deve definir a propriedade NewMaximumRows . Se não quiseres alterar o valor atual, podes definir a NewMaximumRows propriedade para o valor da MaximumRows propriedade do DataPager controlo. Pode aceder ao DataPager controlo através da Item propriedade.

Aplica-se a

Ver também