PagerSettings PagerSettings PagerSettings PagerSettings Class

Definición

Representa las propiedades de los controles de paginación en un control que admite paginación.Represents the properties of the paging controls in a control that supports pagination. Esta clase no puede heredarse.This class cannot be inherited.

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

Ejemplos

En el ejemplo de código siguiente se muestra cómo PagerSettings utilizar el objeto contenido en la PagerSettings propiedad para personalizar el texto de los botones que se muestran en la fila de paginación de GridView un control.The following code example demonstrates how to use the PagerSettings object that is contained in the PagerSettings property to customize the text of the buttons that are displayed in the pager row of a 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 GridView( DetailsViewcomo los FormView controles, y) pueden mostrar un conjunto de controles denominado buscapersonas que permiten al usuario navegar por las páginas del control.Controls that support pagination (such as the GridView, DetailsView, and FormView controls) can display a set of controls called the pager that allows the user to navigate the pages within the control. Estos PagerSettings controles usan la clase para representar las propiedades del buscapersonas.The PagerSettings class is used by these controls to represent the properties of the pager. En general, el PagerSettings objeto se almacena en la PagerSettings propiedad del control.In general, the PagerSettings object is stored in the PagerSettings property of the control. Puede personalizar el buscapersonas estableciendo las propiedades del PagerSettings objeto.You can customize the pager by setting the properties of the PagerSettings object.

El buscapersonas admite varios modos de presentación distintos.The pager supports several different display modes. Para especificar el modo en el que se va a mostrar el buscapersonas Mode , establezca la propiedad.To specify the mode in which to display the pager, set the Mode property. En la tabla siguiente se describen los distintos modos.The following table describes the different modes.

ModoMode DescripciónDescription
NextPrevious Botones de página anterior y página siguiente.Previous-page and next-page buttons.
NextPreviousFirstLast Botones de página anterior, página siguiente, primera página y última página.Previous-page, next-page, first-page, and last -page buttons.
Numeric Botones de vínculo numerados para tener acceso directamente a las páginas.Numbered link buttons to access pages directly.
NumericFirstLast Botones numerados: vínculo, primer vínculo y último vínculo.Numbered-link, first-link, and last-link buttons.

Cuando la Mode propiedad se establece en el NextPreviousvalor NextPreviousFirstLast, o NumericFirstLast , puede personalizar el texto de los botones no numéricos estableciendo las propiedades que se muestran en la tabla siguiente.When the Mode property is set to the NextPrevious, NextPreviousFirstLast, or NumericFirstLast value you can customize the text of the non-numeric buttons by setting the properties shown in the following table.

Propiedad.Property DescripciónDescription
FirstPageText Texto para el botón de primera página.Text for the first-page button.
PreviousPageText Texto del botón de página anterior.Text for the previous-page button.
NextPageText Texto del botón de página siguiente.Text for the next-page button.
LastPageText Texto del botón de última página.Text for the last-page button.

Como alternativa, también puede mostrar imágenes para los botones no numéricos estableciendo las propiedades como se muestra en la tabla siguiente.As an alternative, you can also display images for the non-numeric buttons by setting the properties as shown in the following table.

Propiedad.Property DescripciónDescription
FirstPageImageUrl La dirección URL de la imagen que se va a mostrar para el botón de primera página.The URL to an image to display for the first-page button.
PreviousPageImageUrl La dirección URL de la imagen que se va a mostrar para el botón de página anterior.The URL to an image to display for the previous-page button.
NextPageImageUrl La dirección URL de la imagen que se va a mostrar para el botón de página siguiente.The URL to an image to display for the next-page button.
LastPageImageUrl La dirección URL de la imagen que se va a mostrar para el botón de última página.The URL to an image to display for the last-page button.

Nota

Cuando se establece una propiedad de imagen, la propiedad de texto correspondiente actúa como el texto alternativo de la imagen.When an image property is set, the corresponding text property acts as the alternate text for the image. Por ejemplo, cuando se FirstPageImageUrl establece la propiedad, el texto especificado por la FirstPageText propiedad se muestra como el texto alternativo de la imagen.For example, when the FirstPageImageUrl property is set, the text that is specified by the FirstPageText property is displayed as the alternate text for the image. En los exploradores que admiten la información sobre herramientas, este texto también se muestra como información sobre herramientas para el botón correspondiente.On browsers that support ToolTips, this text is also displayed as a ToolTip for the corresponding button.

Cuando la Mode propiedad se establece en el Numeric valor NumericFirstLast o, puede especificar el número de botones de página que se van a mostrar en el buscapersonas PageButtonCount estableciendo la propiedad.When the Mode property is set to the Numeric or NumericFirstLast value, you can specify the number of page buttons to display in the pager by setting the PageButtonCount property.

El buscapersonas se puede mostrar en la parte superior, inferior o en la parte superior e inferior de un control.The pager can be displayed at the top, the bottom, or both the top and bottom of a control. Para especificar la posición del buscapersonas, establezca la Position propiedad.To specify the position of the pager, set the Position property. Para mostrar u ocultar el buscapersonas, utilice la Visible propiedad.To show or hide the pager, use the Visible property.

Constructores

PagerSettings() PagerSettings() PagerSettings() PagerSettings()

Inicializa una nueva instancia de la clase PagerSettings.Initializes a new instance of the PagerSettings class.

Propiedades

FirstPageImageUrl FirstPageImageUrl FirstPageImageUrl FirstPageImageUrl

Obtiene o establece la dirección URL de la imagen que se va a mostrar para el botón de primera página.Gets or sets the URL to an image to display for the first-page button.

FirstPageText FirstPageText FirstPageText FirstPageText

Obtiene o establece el texto que se muestra para el botón de primera página.Gets or sets the text to display for the first-page button.

LastPageImageUrl LastPageImageUrl LastPageImageUrl LastPageImageUrl

Obtiene o establece la dirección URL de la imagen que se va a mostrar para el botón de última página.Gets or sets the URL to an image to display for the last-page button.

LastPageText LastPageText LastPageText LastPageText

Obtiene o establece el texto que se muestra para el botón de última página.Gets or sets the text to display for the last-page button.

Mode Mode Mode Mode

Obtiene o establece el modo en el que se muestran los controles de paginación en un control que admite paginación.Gets or sets the mode in which to display the pager controls in a control that supports pagination.

NextPageImageUrl NextPageImageUrl NextPageImageUrl NextPageImageUrl

Obtiene o establece la dirección URL de la imagen que se va a mostrar para el botón de página siguiente.Gets or sets the URL to an image to display for the next-page button.

NextPageText NextPageText NextPageText NextPageText

Obtiene o establece el texto que se muestra para el botón de página siguiente.Gets or sets the text to display for the next-page button.

PageButtonCount PageButtonCount PageButtonCount 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.Gets or sets the number of page buttons to display in the pager when the Mode property is set to the Numeric or NumericFirstLast value.

Position Position Position Position

Obtiene o establece un valor que especifica la ubicación donde se muestra el elemento de paginación.Gets or sets a value that specifies the location where the pager is displayed.

PreviousPageImageUrl PreviousPageImageUrl PreviousPageImageUrl PreviousPageImageUrl

Obtiene o establece la dirección URL de la imagen que se va a mostrar para el botón de página anterior.Gets or sets the URL to an image to display for the previous-page button.

PreviousPageText PreviousPageText PreviousPageText PreviousPageText

Obtiene o establece el texto que se muestra para el botón de página anterior.Gets or sets the text to display for the previous page button.

Visible Visible Visible Visible

Obtiene o establece un valor que indica si se muestran los controles de paginación en un control que admite paginación.Gets or sets a value indicating whether the paging controls are displayed in a control that supports pagination.

Métodos

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Recupera la representación en forma de cadena de un objeto PagerSettings.Retrieves the string representation of a PagerSettings object.

Eventos

PropertyChanged PropertyChanged PropertyChanged PropertyChanged

Aparece cuando una propiedad de un objeto PagerSettings cambia de valores.Occurs when a property of a PagerSettings object changes values.

Implementaciones de interfaz explícitas

IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

Obtiene un valor que indica si el control de servidor está realizando el seguimiento de los cambios en su estado de vista.Gets a value that indicates whether the server control is tracking its view state changes.

IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

Carga el estado de vista guardado previamente del objeto PagerSettings.Loads the previously saved view state of the PagerSettings object.

IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

Guarda el estado de vista actual del objeto PagerSettings.Saves the current view state of the PagerSettings object.

IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() 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.Marks the starting point at which to begin tracking and saving view state changes to the PagerSettings object.

Se aplica a

Consulte también: