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 DataPager campo 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 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 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 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 Button control. |
| ButtonType.Image | Un ImageButton control. |
| ButtonType.Link | Un LinkButton control. |
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 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
| Nombre | Description |
|---|---|
| NumericPagerField() |
Inicializa una nueva instancia de la clase NumericPagerField. |
Propiedades
| Nombre | Description |
|---|---|
| ButtonCount |
Obtiene o establece el número de botones que se van a mostrar en un NumericPagerField objeto . |
| ButtonType |
Obtiene o establece el tipo de botón que se va a mostrar en el campo del buscapersonas. |
| CurrentPageLabelCssClass |
Obtiene o establece la clase de hoja de estilos en cascada (CSS) que se usa para aplicar estilo al número de página actual. |
| DataPager |
Obtiene una referencia al buscapersonas de datos al que está asociado el DataPagerField objeto. (Heredado de DataPagerField) |
| IsTrackingViewState |
Obtiene un valor que indica si el DataPagerField objeto está realizando un seguimiento de los cambios de 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 NumericPagerField objeto . |
| 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 usa 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 usa 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 NumericPagerField objeto . |
| 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 |
Obtiene 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 no importantes se representarán entre los controles. |
| ViewState |
Obtiene un diccionario de información de estado que permite guardar y restaurar el estado de vista de un DataPagerField objeto en varias solicitudes para la misma página. (Heredado de DataPagerField) |
| Visible |
Obtiene o establece un valor que indica si se representa un campo de paginación de datos. (Heredado de DataPagerField) |
Métodos
| Nombre | Description |
|---|---|
| CloneField() |
Crea una copia del objeto actual derivado de DataPagerField. (Heredado de DataPagerField) |
| CopyProperties(DataPagerField) |
Copia las propiedades del objeto actual NumericPagerField en el objeto especificado DataPagerField . |
| CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32) |
Crea los controles de la interfaz de usuario (UI) para el objeto de campo del buscapersonas y los agrega al contenedor especificado. |
| CreateField() |
Crea y devuelve una nueva instancia de la NumericPagerField clase . |
| Equals(Object) |
Determina si el objeto especificado es igual al objeto actual NumericPagerField . |
| GetHashCode() |
Actúa como una función hash para la clase NumericPagerField. |
| GetQueryStringNavigateUrl(Int32) |
Crea una dirección URL que contiene un campo de cadena de consulta que tiene 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 se producen en el NumericPagerField objeto y realiza la acción adecuada. |
| LoadViewState(Object) |
Restaura la información de estado de vista que se guardó anteriormente. (Heredado de DataPagerField) |
| MemberwiseClone() |
Crea una copia superficial del Objectactual. (Heredado de Object) |
| OnFieldChanged() |
Genera el evento |
| SaveViewState() |
Guarda los cambios realizados en el DataPagerField estado de vista del objeto. (Heredado de DataPagerField) |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
| TrackViewState() |
Hace que el DataPagerField objeto realice un seguimiento de los cambios en su estado de vista para que se puedan almacenar en la propiedad del ViewState control y conservarse en las solicitudes de la misma página. (Heredado de DataPagerField) |
Implementaciones de interfaz explícitas
| Nombre | Description |
|---|---|
| IStateManager.IsTrackingViewState |
Obtiene un valor que indica si el DataPagerField objeto está realizando un seguimiento de los cambios de estado de vista. (Heredado de DataPagerField) |
| IStateManager.LoadViewState(Object) |
Restaura la información de estado de vista que se guardó anteriormente. (Heredado de DataPagerField) |
| IStateManager.SaveViewState() |
Guarda los cambios realizados en el DataPagerField estado de vista del objeto. (Heredado de DataPagerField) |
| IStateManager.TrackViewState() |
Hace que el DataPagerField objeto realice un seguimiento de los cambios en su estado de vista para que se puedan almacenar en la propiedad del ViewState control y conservarse en las solicitudes de la misma página. (Heredado de DataPagerField) |
