Compartir a través de


PagerSettings Clase

Definición

Representa las propiedades de los controles de paginación en un control que admite paginación. Esta clase no puede heredarse.

public ref class PagerSettings sealed : System::Web::UI::IStateManager
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))]
public sealed class PagerSettings : System.Web.UI.IStateManager
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))>]
type PagerSettings = class
    interface IStateManager
Public NotInheritable Class PagerSettings
Implements IStateManager
Herencia
PagerSettings
Atributos
Implementaciones

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el PagerSettings objeto contenido en la PagerSettings propiedad para personalizar el texto de los botones que se muestran en la fila de buscapersonas de un GridView 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 runat="server">
    <title>PagerSetting Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>PagerSetting Example</h3>
                       
        <asp:gridview id="CustomerGridView"
          datasourceid="CustomerDataSource"
          autogeneratecolumns="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          runat="server">
          
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"   
            position="Bottom"/> 
            
        </asp:gridview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the Web.config file.                            -->
        <asp:sqldatasource id="CustomerDataSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </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 runat="server">
    <title>PagerSetting Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>PagerSetting Example</h3>
                       
        <asp:gridview id="CustomerGridView"
          datasourceid="CustomerDataSource"
          autogeneratecolumns="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          runat="server">
          
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"   
            position="Bottom"/> 
            
        </asp:gridview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the Web.config file.                            -->
        <asp:sqldatasource id="CustomerDataSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </form>
  </body>
</html>

Comentarios

Los controles que admiten la paginación (como los GridViewcontroles , DetailsViewy FormView ) pueden mostrar un conjunto de controles denominados buscapersonas que permite al usuario navegar por las páginas dentro del control. Estos PagerSettings controles usan la clase para representar las propiedades del buscapersonas. En general, el PagerSettings objeto se almacena en la PagerSettings propiedad del control . Puede personalizar el buscapersonas estableciendo las propiedades del PagerSettings objeto .

El buscapersonas admite varios modos de visualización diferentes. Para especificar el modo en el que se va a mostrar el buscapersonas, establezca la Mode propiedad . En la tabla siguiente se describen los distintos modos.

Mode Descripción
NextPrevious Botones de página anterior y página siguiente.
NextPreviousFirstLast Botones previous-page, next-page, first-page y last -page.
Numeric Botones de vínculo numerados para acceder directamente a las páginas.
NumericFirstLast Botones de vínculo numerado, primer vínculo y último vínculo.

Cuando la Mode propiedad se establece en el NextPreviousvalor , NextPreviousFirstLasto NumericFirstLast , puede personalizar el texto de los botones no numéricos estableciendo las propiedades que se muestran en la tabla siguiente.

Propiedad Descripción
FirstPageText Texto del botón de primera página.
PreviousPageText Texto del botón de página anterior.
NextPageText Texto del botón de página siguiente.
LastPageText Texto del botón de la última página.

Como alternativa, también puede mostrar imágenes para los botones no numéricos estableciendo las propiedades como se muestra en la tabla siguiente.

Propiedad Descripción
FirstPageImageUrl La dirección URL de la imagen que se va a mostrar para el botón de primera página.
PreviousPageImageUrl La dirección URL de la imagen que se va a mostrar para el botón de página anterior.
NextPageImageUrl La dirección URL de la imagen que se va a mostrar para el botón de página siguiente.
LastPageImageUrl La dirección URL de la imagen que se va a mostrar para el botón de última página.

Nota

Cuando se establece una propiedad de imagen, la propiedad de texto correspondiente actúa como texto alternativo para la imagen. Por ejemplo, cuando se establece la FirstPageImageUrl propiedad, el texto especificado por la FirstPageText propiedad se muestra como texto alternativo para la imagen. 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.

Cuando la Mode propiedad se establece en el Numeric valor o NumericFirstLast , puede especificar el número de botones de página que se mostrarán en el buscapersonas estableciendo la PageButtonCount propiedad .

El buscapersonas se puede mostrar en la parte superior, en la parte inferior o en la parte superior e inferior de un control. Para especificar la posición del buscapersonas, establezca la Position propiedad . Para mostrar u ocultar el buscapersonas, utilice la Visible propiedad .

Constructores

PagerSettings()

Inicializa una nueva instancia de la clase PagerSettings.

Propiedades

FirstPageImageUrl

Obtiene o establece la dirección URL de la imagen que se va a mostrar para el botón de primera página.

FirstPageText

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

LastPageImageUrl

Obtiene o establece la dirección URL de la imagen que se va a mostrar para el botón de última página.

LastPageText

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

Mode

Obtiene o establece el modo en el que se muestran los controles de paginación en un control que admite paginación.

NextPageImageUrl

Obtiene o establece la dirección URL de la imagen que se va a mostrar para el botón de página siguiente.

NextPageText

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

PageButtonCount

Obtiene o establece el número de botones de página que se van a mostrar en el elemento de paginación cuando la propiedad Mode se establece en el valor Numeric o NumericFirstLast.

Position

Obtiene o establece un valor que especifica la ubicación donde se muestra el elemento de paginación.

PreviousPageImageUrl

Obtiene o establece la dirección URL de la imagen que se va a mostrar para el botón de página anterior.

PreviousPageText

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

Visible

Obtiene o establece un valor que indica si se muestran los controles de paginación en un control que admite paginación.

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
ToString()

Recupera la representación en forma de cadena de un objeto PagerSettings.

Eventos

PropertyChanged

Aparece cuando una propiedad de un objeto PagerSettings cambia de valores.

Implementaciones de interfaz explícitas

IStateManager.IsTrackingViewState

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

IStateManager.LoadViewState(Object)

Carga el estado de vista guardado previamente del objeto PagerSettings.

IStateManager.SaveViewState()

Guarda el estado de vista actual del objeto PagerSettings.

IStateManager.TrackViewState()

Marca el punto en el que debe comenzar el seguimiento y el almacenamiento de los cambios del estado de vista realizados en el objeto PagerSettings.

Se aplica a

Consulte también