DetailsView.AllowPaging Propriedade

Definição

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

Recebe ou define um valor que indica se a funcionalidade de paginação está ativada.

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 de Propriedade

Boolean

true para ativar a funcionalidade de paginação; caso contrário, false. A predefinição é false.

Exemplos

O exemplo de código seguinte demonstra como usar a AllowPaging propriedade para ativar as capacidades de paginação do DetailsView controlo.

<%@ 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>

Observações

O DetailsView controlo tem capacidades de paginação integradas, que permitem ao utilizador navegar para um registo diferente na fonte de dados.

O DetailsView controlo pode executar tanto a interface do utilizador (UI) como a paginação da fonte de dados. A funcionalidade de paginação da interface pode ser usada com qualquer objeto fonte de dados que suporte a System.Collections.ICollection interface. Para cada operação de paginação, o controlo DetailsView consulta a fonte de dados para toda a coleção de dados e seleciona a linha a exibir, basicamente descartando os dados restantes.

Se uma fonte de dados for DataSourceView implementada e a CanPage propriedade devolver true, o DetailsView controlo usará paginação da fonte de dados em vez da paginação UI. Neste caso, o controlo DetailsView irá consultar apenas a linha necessária para cada operação de paginação. Assim, a paginação da fonte de dados é mais eficiente do que a paginação UI. Apenas o ObjectDataSourceView objeto suporta paginação da fonte de dados sem modificação.

Para ativar a funcionalidade de paginação, defina a AllowPaging propriedade para true. Pode determinar o número total de itens na fonte de dados subjacente usando a PageCount propriedade. Para determinar o índice do item atualmente apresentado, use a PageIndex propriedade.

Quando a paginação está ativada, uma linha adicional chamada linha do pager é automaticamente exibida DetailsView no controlo. A linha do pager contém os controlos de navegação da página e pode ser exibida no topo, inferior ou ambos no topo e na parte inferior do controlo. A linha do pager tem dois modos de visualização incorporados: páginas numeradas e links para a página seguinte e anterior (por defeito). O modo de páginas numeradas apresenta links para as páginas individuais, permitindo ao utilizador navegar até uma página específica. Os modos links seguinte e anterior exibem controlos que permitem ao utilizador navegar para a página seguinte ou para a página anterior.

Note

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

Pode controlar as definições da linha do pager (como o modo de visualização do pager, o número de links de página a mostrar de cada vez e o rótulo de texto do controlo do pager) usando a PagerSettings propriedade. Para controlar a aparência da linha do pager (incluindo a cor de fundo, cor da fonte e posição), use a PagerStyle propriedade. O DetailsView controlo também permite definir um modelo personalizado para a linha do pager. Para mais informações sobre a criação de um modelo personalizado de linha para pager, consulte PagerTemplate.

O DetailsView controlo fornece vários eventos que pode usar para realizar uma ação personalizada quando ocorre a paginação. A tabela seguinte lista os eventos disponíveis.

Event Description
PageIndexChanged Ocorre quando um dos botões do pager é clicado, mas depois de o DetailsView controlo tratar da operação de paginação. Este evento é comumente usado quando precisa de executar uma tarefa depois de o utilizador navegar para um registo diferente no controlo.
PageIndexChanging Ocorre quando um dos botões do pager é clicado, mas antes do controlo DetailsView tratar da operação de paginação. Este evento é frequentemente usado para cancelar a operação de paginação.

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

Aplica-se a

Ver também