NumericPagerField Clase
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í.
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::DataPagerFieldpublic class NumericPagerField : System.Web.UI.WebControls.DataPagerFieldtype NumericPagerField = class
inherit DataPagerFieldPublic Class NumericPagerField
Inherits DataPagerField- Herencia
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 |
| 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) |
