DetailsView.AllowPaging Propriedade
Definição
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, setPublic Overridable Property AllowPaging As BooleanValor da propriedade
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.