GridView.AllowPaging Propriedade

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém ou define um valor que indica se o recurso de paginação está habilitado.

public:
 virtual property bool AllowPaging { bool get(); void set(bool value); };

public virtual bool AllowPaging { get; set; }

member this.AllowPaging : bool with get, set

Public Overridable Property AllowPaging As Boolean

Valor da propriedade

Boolean

true se o recurso de paginação estiver habilitado; caso contrário, false. O padrão é false.

Exemplos

O exemplo a GridView seguir demonstra como usar a AllowPaging propriedade para habilitar declarativamente o recurso de paginação no controle.


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>GridView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView AllowPaging Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">
                
        <pagersettings mode="Numeric"
          position="Bottom"           
          pagebuttoncount="10"/>
                      
        <pagerstyle backcolor="LightBlue"
          height="30px"
          verticalalign="Bottom"
          horizontalalign="Center"/>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
        
    </form>
  </body>
</html>


<%@ Page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>GridView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView AllowPaging Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">
                
        <pagersettings mode="Numeric"
          position="Bottom"           
          pagebuttoncount="10"/>
                      
        <pagerstyle backcolor="LightBlue"
          height="30px"
          verticalalign="Bottom"
          horizontalalign="Center"/>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
        
    </form>
  </body>
</html>

Comentários

Em vez de exibir todos os registros na fonte de dados ao mesmo tempo, o GridView controle pode dividir automaticamente os registros em páginas. Se a fonte de dados der suporte à funcionalidade de paginação, o GridView controle poderá aproveitar isso e fornecer funcionalidade de paginação interna. O recurso de paginação pode ser usado com qualquer objeto de fonte de dados que dê suporte à System.Collections.ICollection interface ou a uma fonte de dados que dê suporte à capacidade de paginação.

Para habilitar o recurso de paginação, defina a AllowPaging propriedade como true. Por padrão, o GridView controle exibe 10 registros em uma página por vez. Você pode alterar o número de registros exibidos em uma página definindo a PageSize propriedade. Para determinar o número total de páginas necessárias para exibir o conteúdo da fonte de dados, use a PageCount propriedade. Você pode determinar o índice da página exibida no momento usando a PageIndex propriedade.

Quando a paginação é habilitada, uma linha adicional chamada linha pager é exibida automaticamente no GridView controle. A linha do pager contém controles que permitem que o usuário navegue até as outras páginas. Você pode controlar as configurações da linha do pager (como o modo de exibição do pager, o número de links de página a serem exibidos por vez e os rótulos de texto do controle de pager) usando a PagerSettings propriedade. A linha do pager pode ser exibida na parte superior, inferior ou na parte superior e inferior do controle definindo a Position propriedade. Você também pode selecionar entre um dos quatro modos de exibição de pager internos definindo a Mode propriedade. A tabela a seguir descreve os modos de exibição internos.

Mode	Descrição
`PagerButton.NextPrevious`	Um conjunto de controles de paginação que consistem em botões anteriores e próximos.
`PagerButton.NextPreviousFirstLast`	Um conjunto de controles de paginação que consistem nos botões anterior, próximo, primeiro e último.
`PagerButton.Numeric`	Um conjunto de controles de paginação que consiste em botões de link numerados para acessar páginas diretamente. Esse é o modo padrão.
`PagerButton.NumericFirstLast`	Um conjunto de controles de paginação que consistem em botões numerados e primeiro e último link.

Para controlar a aparência da linha do pager (incluindo sua cor da tela de fundo, cor da fonte e posição), use a PagerStyle propriedade.

Observação

O GridView controle oculta automaticamente a linha do pager quando a fonte de dados contém apenas uma página de registros.

O GridView controle também permite que você defina um modelo personalizado para a linha do pager. Para obter mais informações sobre como criar um modelo de linha de pager personalizado, consulte PagerTemplate.

O GridView controle fornece vários eventos que você pode usar para executar uma ação personalizada quando ocorre paginação. A tabela a seguir lista os eventos disponíveis.

Evento	Descrição
PageIndexChanged	Ocorre quando um dos botões de paginação é acionado, mas após o controle GridView manipular a operação de paginação. Esse evento é comumente usado quando você precisa executar uma tarefa depois que o usuário navega para uma página diferente no controle.
PageIndexChanging	Ocorre quando um dos botões de paginação é acionado, mas antes de o controle GridView manipular a operação de paginação. Esse evento geralmente é usado para cancelar a operação de paginação.

Aplica-se a