DetailsView.AllowPaging Propriedade

  • Referência

Definição

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

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 para habilitar o recurso de paginação; caso contrário, false. O padrão é false.

Exemplos

O exemplo de código a seguir demonstra como usar a AllowPaging propriedade para habilitar os recursos de paginação do DetailsView 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>DetailsView AllowPaging Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AllowPaging Example</h3>
                
        <asp:detailsview id="StoresDetailView"
          datasourceid="Customers"
          autogeneraterows="true" 
          allowpaging="true"
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
            
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"/>
            
          <pagerstyle forecolor="White"
            backcolor="Blue"
            font-names="Arial"
            font-size="8" />   
        </asp:detailsview>
            
        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database. -->           
        <asp:SqlDataSource ID="Customers" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthwindConnectionString %>"
          SelectCommand="SELECT [CompanyName], [ContactName], 
             [CustomerID] FROM [Customers]">
        </asp:SqlDataSource>
            
      </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>DetailsView AllowPaging Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AllowPaging Example</h3>
                
        <asp:detailsview id="StoresDetailView"
          datasourceid="Customers"
          autogeneraterows="true" 
          allowpaging="true"
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
            
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"/>
            
          <pagerstyle forecolor="White"
            backcolor="Blue"
            font-names="Arial"
            font-size="8" />   
        </asp:detailsview>
            
        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database. -->           
        <asp:SqlDataSource ID="Customers" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthwindConnectionString %>"
          SelectCommand="SELECT [CompanyName], [ContactName], 
             [CustomerID] FROM [Customers]">
        </asp:SqlDataSource>
            
      </form>
  </body>
</html>

Comentários

O DetailsView controle tem recursos de paginação internos, que permitem que um usuário navegue até um registro diferente na fonte de dados.

O DetailsView controle pode executar a interface do usuário (interface do usuário) e a paginação da fonte de dados. O recurso de paginação da interface do usuário pode ser usado com qualquer objeto de fonte de dados que dê suporte à System.Collections.ICollection interface. Para cada operação de paginação, o DetailsView controle consulta a fonte de dados de toda a coleta de dados e seleciona a linha a ser exibida, essencialmente descartando os dados restantes.

Se uma fonte de dados for implementada DataSourceView e a CanPage propriedade retornar true, o DetailsView controle usará paginação de fonte de dados em vez de paginação de interface do usuário. Nesse caso, o DetailsView controle consultará apenas a linha necessária para cada operação de paginação. Portanto, a paginação da fonte de dados é mais eficiente do que a paginação de interface do usuário. Somente o objeto dá suporte à ObjectDataSourceView paginação da fonte de dados sem modificação.

Para habilitar o recurso de paginação, defina a AllowPaging propriedade como true. Você pode determinar o número total de itens na fonte de dados subjacente usando a PageCount propriedade. Para determinar o índice do item exibido no momento, use a PageIndex propriedade.

Quando a paginação é habilitada, uma linha adicional chamada linha do pager é exibida automaticamente no DetailsView controle. A linha do pager contém os controles de navegação de página e pode ser exibida na parte superior, inferior ou na parte superior e inferior do controle. A linha do pager tem dois modos de exibição de pager internos: páginas numeradas e links de páginas seguintes e anteriores (padrão). O modo de páginas numeradas exibe links para as páginas individuais, permitindo que o usuário navegue até uma página específica. O modo de links seguinte e anterior exibe controles que permitem que o usuário navegue até a página seguinte ou anterior.

Observação

O DetailsView controle oculta automaticamente a linha do pager quando a fonte de dados contém menos de dois registros.

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 o rótulo de texto do controle pager) usando a PagerSettings propriedade. 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. O DetailsView 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 DetailsView controle fornece vários eventos que você pode usar para executar uma ação personalizada quando a paginação ocorre. 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 DetailsView manipular a operação de paginação. Esse evento geralmente é usado quando você precisa executar uma tarefa depois que o usuário navega para um registro diferente no controle.
PageIndexChanging Ocorre quando um dos botões de paginação é acionado, mas antes de o controle DetailsView manipular a operação de paginação. Esse evento geralmente é usado para cancelar a operação de paginação.

O valor é armazenado no estado de AllowPaging exibição.

Aplica-se a

Confira também