DetailsView.AllowPaging Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece un valor que indica si la característica de paginación está habilitada.
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 de propiedad
Es true para habilitar la característica de paginación; en caso contrario, es false. De manera predeterminada, es false.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar la AllowPaging propiedad para habilitar las funcionalidades de paginación del DetailsView control.
<%@ 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>
Comentarios
El DetailsView control tiene funcionalidades de paginación integradas, que permiten al usuario navegar a un registro diferente en el origen de datos.
El DetailsView control puede realizar tanto la interfaz de usuario (UI) como la paginación del origen de datos. La característica de paginación de la interfaz de usuario se puede usar con cualquier objeto de origen de datos que admita la System.Collections.ICollection interfaz . Para cada operación de paginación, el DetailsView control consulta el origen de datos para toda la recopilación de datos y selecciona la fila que se va a mostrar, descartando básicamente los datos restantes.
Si un origen de datos implementa DataSourceView y la CanPage propiedad devuelve true, el control usará la DetailsView paginación del origen de datos en lugar de la paginación de la interfaz de usuario. En este caso, el DetailsView control consultará solo la fila necesaria para cada operación de paginación. Por lo tanto, la paginación del origen de datos es más eficaz que la paginación de la interfaz de usuario. Solo el objeto admite la ObjectDataSourceView paginación del origen de datos sin modificaciones.
Para habilitar la característica de paginación, establezca la AllowPaging propiedad en true. Puede determinar el número total de elementos del origen de datos subyacente mediante la PageCount propiedad . Para determinar el índice del elemento mostrado actualmente, use la PageIndex propiedad .
Cuando la paginación está habilitada, se muestra automáticamente una fila adicional denominada fila del buscapersonas en el DetailsView control . La fila del buscapersonas contiene los controles de navegación de página y se puede mostrar en la parte superior, inferior o tanto en la parte superior como en la inferior del control. La fila del buscapersonas tiene dos modos de visualización de buscapersonas integrados: páginas numeradas y vínculos de página siguientes y anteriores (valor predeterminado). El modo de páginas numeradas muestra vínculos para las páginas individuales, lo que permite al usuario navegar a una página específica. En el modo de vínculos siguientes y anteriores se muestran los controles que permiten al usuario navegar a la página siguiente o anterior.
Nota:
El DetailsView control oculta automáticamente la fila del buscapersonas cuando el origen de datos contiene menos de dos registros.
Puede controlar la configuración de la fila del buscapersonas (como el modo de visualización del buscapersonas, el número de vínculos de página que se mostrarán a la vez y la etiqueta de texto del control de paginación) mediante la PagerSettings propiedad . Para controlar la apariencia de la fila del buscapersonas (incluido su color de fondo, color de fuente y posición), use la PagerStyle propiedad . El DetailsView control también permite definir una plantilla personalizada para la fila del buscapersonas. Para obtener más información sobre cómo crear una plantilla de fila de buscapersonas personalizada, vea PagerTemplate.
El DetailsView control proporciona varios eventos que puede usar para realizar una acción personalizada cuando se produce la paginación. En la tabla siguiente se enumeran los eventos disponibles.
| Evento | Descripción |
|---|---|
| PageIndexChanged | Se produce cuando se hace clic en uno de los botones de paginación, pero después de que el control DetailsView se ocupe de la operación de paginación. Este evento se usa normalmente cuando se necesita realizar una tarea después de que el usuario navegue a un registro diferente en el control. |
| PageIndexChanging | Se produce cuando se hace clic en uno de los botones de paginación, pero antes de que el control DetailsView se ocupe de la operación de paginación. Este evento se suele usar para cancelar la operación de paginación. |
El valor de AllowPaging se almacena en estado de vista.
