Compartir a través de


NumericPagerField Clase

Definición

Representa un campo DataPager que permite a los usuarios seleccionar una página por número de página.

public ref class NumericPagerField : System::Web::UI::WebControls::DataPagerField
public class NumericPagerField : System.Web.UI.WebControls.DataPagerField
type NumericPagerField = class
    inherit DataPagerField
Public Class NumericPagerField
Inherits DataPagerField
Herencia
NumericPagerField

Ejemplos

En el ejemplo siguiente se muestra cómo usar un NumericPagerField objeto para paginar los datos que se muestran en un ListView 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 id="Head1" runat="server">
    <title>NumericPagerField Example</title>    
    <style type="text/css">
      body 	
      {
        text-align: center;
        font: 12px Arial, Helvetica, sans-serif;
      } 
      table
      {
        padding: 2px 2px 2px 2px;
        border: 1px solid;
        width: 500px;
      }     
      .CurrentPage 
      {
        padding: 2px 6px;
        border: solid 1px #ddd; 
        background: #2E8B57;
        color:White;
      }
      .PrevNext,.PageNumber
      {
        padding: 2px 6px;
        border: solid 1px #ddd;
        text-decoration: none;
        color: #2E8B57;
      }
      .PageNumber:hover, .PrevNext:hover
      {
        background-color: #FFA500;
        color: White;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NumericPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td align="left">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("LastName") + ", " + Eval("FirstName")%>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>
      <br />

      <div>
        <asp:DataPager runat="server" 
          ID="ContactsDataPager" 
          PagedControlID="ContactsListView">
          <Fields>
            <asp:NumericPagerField 
              PreviousPageText="< Prev"
              NextPageText="Next >"
              ButtonCount="10"
              NextPreviousButtonCssClass="PrevNext"
              CurrentPageLabelCssClass="CurrentPage"
              NumericButtonCssClass="PageNumber" />
          </Fields>
        </asp:DataPager>
      </div>
      <br />

      <!-- 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>
<%@ 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 id="Head1" runat="server">
    <title>NumericPagerField Example</title>    
    <style type="text/css">
      body 	
      {
        text-align: center;
        font: 12px Arial, Helvetica, sans-serif;
      } 
      table
      {
        padding: 2px 2px 2px 2px;
        border: 1px solid;
        width: 500px;
      }     
      .CurrentPage 
      {
        padding: 2px 6px;
        border: solid 1px #ddd; 
        background: #2E8B57;
        color:White;
      }
      .PrevNext,.PageNumber
      {
        padding: 2px 6px;
        border: solid 1px #ddd;
        text-decoration: none;
        color: #2E8B57;
      }
      .PageNumber:hover, .PrevNext:hover
      {
        background-color: #FFA500;
        color: White;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NumericPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td align="left">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("LastName") & ", " & Eval("FirstName")%>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>
      <br />

      <div>
        <asp:DataPager runat="server" 
          ID="ContactsDataPager" 
          PagedControlID="ContactsListView">
          <Fields>
            <asp:NumericPagerField 
              PreviousPageText="< Prev"
              NextPageText="Next >"
              ButtonCount="10"
              NextPreviousButtonCssClass="PrevNext"
              CurrentPageLabelCssClass="CurrentPage"
              NumericButtonCssClass="PageNumber" />
          </Fields>
        </asp:DataPager>
      </div>
      <br />

      <!-- 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>

Comentarios

La NumericPagerField clase muestra los controles de navegación en un DataPager control . Los controles se pueden usar para paginar a través de datos que se muestran mediante un control que implementa la IPageableItemContainer interfaz, como el ListView control . El NumericPagerField objeto muestra los números de página como botones que los usuarios pueden hacer clic para pasar a una página específica. El control también muestra los botones de página siguiente y página anterior que permiten a los usuarios acceder a más páginas de datos que las que muestra el control.

Puede personalizar la apariencia del NumericPagerField objeto mediante las propiedades que aparecen en la tabla siguiente.

Propiedad. Descripción
CurrentPageLabelCssClass Clase CSS para el número de página actual.
NextPreviousButtonCssClass Clase CSS para los botones de página siguiente y página anterior.
NumericButtonCssClass Clase CSS para los botones que representan los números de página.

Puede usar la ButtonType propiedad para seleccionar el tipo de botón que se mostrará. En la tabla siguiente se enumeran los tipos de botón disponibles.

Tipo de botón Descripción
ButtonType.Button Un control Button.
ButtonType.Image Control ImageButton.
ButtonType.Link Un control LinkButton.

Los controles dentro del NumericButtonCssClass objeto se representan con espacios no importantes entre ellos. Si desea personalizar este comportamiento, puede usar la RenderNonBreakingSpacesBetweenControls propiedad .

Puede ocultar un NumericPagerField objeto en un DataPager control estableciendo la Visible propiedad falseen . No puede controlar la visibilidad de los botones de página siguiente y página anterior. Se muestran mediante el control si el control de datos asociado tiene páginas adicionales disponibles para mostrar. Puede usar la ButtonCount propiedad para especificar cuántos botones se muestran en un NumericPagerField objeto . Cada botón corresponde a un número de página.

Puede establecer el texto del botón de página siguiente estableciendo la NextPageText propiedad . Puede establecer el texto del botón de página anterior mediante la PreviousPageText propiedad .

Cuando la ButtonType propiedad se establece ButtonType.Imageen , debe proporcionar la dirección URL de una imagen que se mostrará para los botones de página siguiente y anterior. Para ello, establezca las NextPageImageUrl propiedades y PreviousPageImageUrl . En ese caso, la propiedad de texto correspondiente se usa como texto alternativo para la imagen. Por ejemplo, el texto especificado por la NextPageImageUrl propiedad se muestra como texto alternativo para el botón de imagen de página siguiente. En los exploradores que admiten información sobre herramientas, este texto también se muestra como información sobre herramientas para el botón correspondiente.

Constructores

NumericPagerField()

Inicializa una nueva instancia de la clase NumericPagerField.

Propiedades

ButtonCount

Obtiene o establece el número de botones que deben mostrarse en un objeto NumericPagerField.

ButtonType

Obtiene o establece el tipo de botón que se va a mostrar en el campo de paginación.

CurrentPageLabelCssClass

Obtiene o establece la clase de hoja de estilos en cascada (CSS) que se utiliza para aplicar estilo al número de página actual.

DataPager

Obtiene una referencia al elemento de paginación de datos al que está asociado el objeto DataPagerField.

(Heredado de DataPagerField)
IsTrackingViewState

Obtiene un valor que indica si el objeto DataPagerField está realizando un seguimiento de los cambios en su estado de vista.

(Heredado de DataPagerField)
NextPageImageUrl

Obtiene o establece la dirección URL de una imagen que se muestra para el botón de página siguiente en el objeto NumericPagerField.

NextPageText

Obtiene o establece el texto que se muestra para el botón de página siguiente.

NextPreviousButtonCssClass

Obtiene o establece la clase de hoja de estilos en cascada (CSS) que se utiliza para aplicar estilo a los botones de página siguiente y página anterior del campo de paginación.

NumericButtonCssClass

Obtiene o establece la clase de hoja de estilos en cascada (CSS) que se utiliza para aplicar estilo a los botones de número de página del campo de paginación.

PreviousPageImageUrl

Obtiene o establece la dirección URL de una imagen que se muestra para el botón de página anterior en el objeto NumericPagerField.

PreviousPageText

Obtiene o establece el texto que se muestra para el botón de página anterior.

QueryStringHandled

Obtiene o establece un valor que indica si se ha evaluado el campo de cadena de consulta.

(Heredado de DataPagerField)
QueryStringValue

Recibe el valor del campo de cadena de consulta de la dirección URL de la solicitud.

(Heredado de DataPagerField)
RenderNonBreakingSpacesBetweenControls

Obtiene o establece un valor que indica si los espacios de no separación se representarán entre los controles.

ViewState

Obtiene un diccionario con información de estado que permite guardar y restaurar el estado de vista de un objeto DataPagerField en distintas solicitudes de la misma página.

(Heredado de DataPagerField)
Visible

Obtiene o establece un valor que indica si debe representarse un campo de paginación de datos.

(Heredado de DataPagerField)

Métodos

CloneField()

Crea una copia del objeto actual que se deriva de DataPagerField.

(Heredado de DataPagerField)
CopyProperties(DataPagerField)

Copia las propiedades del objeto NumericPagerField actual al objeto DataPagerField especificado.

CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)

Crea los controles de interfaz de usuario (UI) para el objeto de campo de paginación y los agrega al contenedor especificado.

CreateField()

Crea y devuelve una nueva instancia de la clase NumericPagerField.

Equals(Object)

Determina si el objeto especificado es igual al objeto NumericPagerField actual.

GetHashCode()

Sirve como función hash para la clase NumericPagerField.

GetQueryStringNavigateUrl(Int32)

Crea una dirección URL que contiene un campo de cadena de consulta con el número de página especificado.

(Heredado de DataPagerField)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
HandleEvent(CommandEventArgs)

Controla los eventos que producen en el objeto NumericPagerField y realiza la acción adecuada.

LoadViewState(Object)

Restaura la información estado de vista que se guardó previamente.

(Heredado de DataPagerField)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
OnFieldChanged()

Genera el evento FieldChanged.

(Heredado de DataPagerField)
SaveViewState()

Guarda los cambios realizados en el estado de vista del objeto DataPagerField.

(Heredado de DataPagerField)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
TrackViewState()

Hace que el objeto DataPagerField realice un seguimiento de los cambios de su estado de vista, de modo que puedan almacenarse en la propiedad ViewState del control y mantenerse en todas las solicitudes de la misma página.

(Heredado de DataPagerField)

Implementaciones de interfaz explícitas

IStateManager.IsTrackingViewState

Obtiene un valor que indica si el objeto DataPagerField está realizando un seguimiento de los cambios en su estado de vista.

(Heredado de DataPagerField)
IStateManager.LoadViewState(Object)

Restaura la información estado de vista que se guardó previamente.

(Heredado de DataPagerField)
IStateManager.SaveViewState()

Guarda los cambios realizados en el estado de vista del objeto DataPagerField.

(Heredado de DataPagerField)
IStateManager.TrackViewState()

Hace que el objeto DataPagerField realice un seguimiento de los cambios de su estado de vista, de modo que puedan almacenarse en la propiedad ViewState del control y mantenerse en todas las solicitudes de la misma página.

(Heredado de DataPagerField)

Se aplica a

Consulte también