NumericPagerField Clase

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.Extensions.dll

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í.

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: Object

DataPagerField
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 controles de navegación en un DataPager control . Los controles se pueden usar para paginar a través de los datos que muestra 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 desplazarse 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 tener acceso a más páginas de datos que las que muestra el control.

Puede personalizar la apariencia del NumericPagerField objeto mediante las propiedades que se enumeran 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 se 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 página 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

NumericPagerField Clase

Definición

Ejemplos

Comentarios

Constructores

Propiedades

Métodos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

Comentarios

Recursos adicionales