PagerSettings Clase

Referencia

Definición

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

Ensamblado:: System.Web.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 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: Object
PagerSettings

Atributos: TypeConverterAttribute

Implementaciones: IStateManager

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