Esta documentación está archivada y no tiene mantenimiento.

NextPreviousPagerField (Clase)

Actualización: noviembre 2007

Representa un campo que muestra los controles de navegación de un control DataPager que permiten a los usuarios desplazarse por los datos página a página.

Espacio de nombres:  System.Web.UI.WebControls
Ensamblado:  System.Web.Extensions (en System.Web.Extensions.dll)

[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class NextPreviousPagerField : DataPagerField
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public class NextPreviousPagerField extends DataPagerField
public class NextPreviousPagerField extends DataPagerField

La clase NextPreviousPagerField representa un campo que muestra los controles de navegación de un control DataPager. Estos controles de navegación se pueden utilizar para recorrer página a página los datos mostrados por un control que implementa la interfaz IPageableItemContainer, como el control ListView.

La clase NextPreviousPagerField proporciona botones que permiten a los usuarios navegar por las páginas de datos de página en página o saltar a la primera o última página de datos.

Puede personalizar la apariencia del objeto NextPreviousPagerField mediante la propiedad ButtonCssClass para establecer el estilo de los botones. También puede utilizar la propiedad ButtonType para elegir el tipo de botón que se muestra. En la siguiente tabla se enumeran los tipos de botones disponibles.

Tipo de botón

Descripción

Button

Control Button.

Image

Control ImageButton.

Link

Control LinkButton.

Puede ocultar un objeto NextPreviousPagerField de un control DataPager si establece la propiedad Visible en false. También puede ocultar botones individuales (los botones de primera página, página anterior, página siguiente y última página) si establece las propiedades ShowFirstPageButton, ShowPreviousPageButton, ShowNextPageButton y ShowLastPageButton en false.

El control NextPreviousPagerField permite especificar texto personalizado para cada botón mediante las propiedades FirstPageText, PreviousPageText, NextPageText y LastPageText.

Cuando la propiedad ButtonType se establece en ButtonType.Image, se debe proporcionar la dirección URL de la imagen que se mostrará para el botón. Puede establecer las imágenes individualmente para cada botón mediante las propiedades FirstPageImageUrl, PreviousPageImageUrl, NextPageImageUrl y LastPageImageUrl.

Cuando la propiedad ButtonType se establece en ButtonType.Image, la propiedad de texto correspondiente actúa como el texto alternativo de la imagen. Por ejemplo, el texto que se especifica mediante la propiedad FirstPageText se muestra como el texto alternativo del botón de imagen de la primera página. En los exploradores que admiten la funcionalidad de información sobre herramientas, este texto también se muestra como información sobre herramientas.

En el ejemplo siguiente se muestra cómo utilizar un objeto NextPreviousPagerField para desplazarse página a página por los datos que se muestran en un control ListView.

<%@ 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 id="Head1" runat="server">
    <title>NextPreviousPagerField Example</title>
  </head>
  <body>
    <form id="form1" runat="server">

      <h3>NextPreviousPagerField Example</h3>

      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="ContactIDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td>
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <asp:DataPager runat="server" ID="ContactsDataPager" PagedControlID="ContactsListView">
        <Fields>
          <asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true" />
        </Fields>
      </asp:DataPager>

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [ContactID], [FirstName], [LastName] FROM Person.Contact">
      </asp:SqlDataSource>

    </form>
  </body>
</html>


System.Object
  System.Web.UI.WebControls.DataPagerField
    System.Web.UI.WebControls.NextPreviousPagerField

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5
Mostrar: