DetailsView.AllowPaging (Propiedad)
Ensamblado: System.Web (en system.web.dll)
/** @property */ public boolean get_AllowPaging () /** @property */ public void set_AllowPaging (boolean value)
public function get AllowPaging () : boolean public function set AllowPaging (value : boolean)
No aplicable.
Valor de propiedad
Es true para habilitar la característica de paginación; en caso contrario, es false. El valor predeterminado es false.El control DetailsView tiene integradas funciones de paginación que permiten al usuario desplazarse a otro registro del origen de datos.
El control DetailsView puede realizar paginación tanto de la interfaz de usuario como del origen de datos. La característica de paginación de la interfaz de usuario se puede utilizar con cualquier objeto de origen de datos que admita la interfaz System.Collections.ICollection. Para cada operación de paginación, el control DetailsView consulta la colección de datos completa en el origen de datos y selecciona la fila que debe mostrar, esencialmente descartando los datos restantes.
Si un origen de datos implementa DataSourceView, y la propiedad CanPage devuelve true, el control DetailsView utilizará la paginación del origen de datos en lugar de la paginación de la interfaz de usuario. En este caso, el control DetailsView consultará sólo la fila necesaria para cada operación de paginación. De ese modo, la paginación del origen de datos es más eficiente que la paginación de la interfaz de usuario. Sólo el objeto ObjectDataSourceView admite paginación del origen de datos sin modificación.
Para habilitar la característica de paginación, establezca la propiedad AllowPaging en true. Puede determinar el número total de elementos del origen de datos subyacente por medio de la propiedad PageCount. Para determinar el índice del elemento actualmente mostrado, utilice la propiedad PageIndex.
Al habilitar la paginación, una fila adicional denominada fila del localizador se muestra automáticamente en el control DetailsView. La fila del localizador contiene los controles de exploración de páginas, y puede mostrarse en la parte superior o inferior del control o en ambas. La fila del localizador dispone de dos modos de presentación integrados: páginas numeradas y vínculos a las páginas anterior y siguiente (opción predeterminada). En el modo de páginas numeradas, se muestran vínculos a las páginas individuales, lo cual permite al usuario desplazarse a una página específica. El modo de vínculos anterior y siguiente muestra controles que permiten al usuario desplazarse a la pagina anterior o siguiente.
 Nota: |
|---|
| El control DetailsView oculta automáticamente la fila del localizador cuando el origen de datos contiene menos de dos registros. |
Puede controlar la configuración de la fila del localizador (por ejemplo, el modo de presentación, el número de vínculos a páginas que se muestran a la vez y la etiqueta de texto del control de paginación) mediante la propiedad PagerSettings. Para controlar el aspecto de la fila del localizador (incluidos el color de fondo, el color de fuente y la posición), utilice la propiedad PagerStyle. El control DetailsView también permite definir una plantilla personalizada para la fila del localizador. Para obtener más información sobre cómo crear una plantilla de fila del localizador personalizada, vea PagerTemplate.
El control DetailsView proporciona varios eventos que puede utilizar para realizar una acción personalizada cuando se produce la paginación. La tabla siguiente enumera los eventos disponibles.
| Evento | Descripción |
|---|---|
| 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. Normalmente este evento se utiliza cuando se necesita realizar una tarea después de que el usuario se desplace a otro registro del control. | |
| 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 suele utilizarse para cancelar la operación de paginación. |
El valor de AllowPaging se almacena en el estado de vista.
En el ejemplo de código siguiente se muestra cómo utilizar la propiedad AllowPaging para habilitar las funciones de paginación del control DetailsView.
<%@ 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>
Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter
Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.