Partilhar via


PagerSettings Classe

Definição

Representa as propriedades dos controles de paginação em um controle compatível com paginação. Essa classe não pode ser herdada.

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
Herança
PagerSettings
Atributos
Implementações

Exemplos

O exemplo de código a seguir demonstra como usar o PagerSettings objeto contido na PagerSettings propriedade para personalizar o texto dos botões exibidos na linha do pager de um GridView controle.


<%@ 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>

Comentários

Controles que dão suporte à paginação (como o GridView, DetailsViewe FormView controles) podem exibir um conjunto de controles chamado pager que permite que o usuário navegue pelas páginas dentro do controle. A PagerSettings classe é usada por esses controles para representar as propriedades do pager. Em geral, o PagerSettings objeto é armazenado na PagerSettings propriedade do controle. Você pode personalizar o pager definindo as propriedades do PagerSettings objeto.

O pager dá suporte a vários modos de exibição diferentes. Para especificar o modo no qual exibir o pager, defina a Mode propriedade. A tabela a seguir descreve os diferentes modos.

Mode Descrição
NextPrevious Botões de página anterior e de próxima página.
NextPreviousFirstLast Botões de página anterior, próxima página, primeira página e última página.
Numeric Botões de link numerados para acessar páginas diretamente.
NumericFirstLast Botões de link numerado, primeiro link e último link.

Quando a Mode propriedade é definida como , NextPreviousou NumericFirstLast valor, NextPreviousFirstLastvocê pode personalizar o texto dos botões não numéricos definindo as propriedades mostradas na tabela a seguir.

Propriedade Descrição
FirstPageText Texto para o botão de primeira página.
PreviousPageText Texto para o botão de página anterior.
NextPageText Texto para o botão da próxima página.
LastPageText Texto para o botão de última página.

Como alternativa, você também pode exibir imagens para os botões não numéricos definindo as propriedades conforme mostrado na tabela a seguir.

Propriedade Descrição
FirstPageImageUrl A URL de uma imagem a ser exibida para o botão de primeira página.
PreviousPageImageUrl A URL de uma imagem a ser exibida para o botão de página anterior.
NextPageImageUrl A URL de uma imagem a ser exibida para o botão da próxima página.
LastPageImageUrl A URL de uma imagem a ser exibida para o botão de última página.

Observação

Quando uma propriedade de imagem é definida, a propriedade de texto correspondente atua como o texto alternativo para a imagem. Por exemplo, quando a FirstPageImageUrl propriedade é definida, o texto especificado pela FirstPageText propriedade é exibido como o texto alternativo para a imagem. Em navegadores que dão suporte a Dicas de Ferramentas, esse texto também é exibido como uma Dica de Ferramenta para o botão correspondente.

Quando a Mode propriedade é definida como o valor ou NumericFirstLast o Numeric valor, você pode especificar o número de botões de página a serem exibidos no pager definindo a PageButtonCount propriedade.

O pager pode ser exibido na parte superior, na parte inferior ou na parte superior e inferior de um controle. Para especificar a posição do pager, defina a Position propriedade. Para mostrar ou ocultar o pager, use a Visible propriedade.

Construtores

PagerSettings()

Inicializa uma nova instância da classe PagerSettings.

Propriedades

FirstPageImageUrl

Obtém ou define a URL para uma imagem a exibir para o botão de primeira página.

FirstPageText

Obtém ou define o texto a ser exibido para o botão de primeira página.

LastPageImageUrl

Obtém ou define a URL para uma imagem a exibir para o botão de última página.

LastPageText

Obtém ou define o texto a ser exibido para o botão de última página.

Mode

Obtém ou define o modo de exibição dos controles de paginação em um controle que dá suporte à paginação.

NextPageImageUrl

Obtém ou define a URL para uma imagem a exibir para o botão de próxima página.

NextPageText

Obtém ou define o texto a ser exibido para o botão de próxima página.

PageButtonCount

Obtém ou define o número de botões de página a serem exibidos no pager quando a propriedade Mode está definida com o valor Numeric ou NumericFirstLast.

Position

Obtém ou define um valor que especifica o local em que o pager é exibido.

PreviousPageImageUrl

Obtém ou define a URL para uma imagem a exibir para o botão de página anterior.

PreviousPageText

Obtém ou define o texto a ser exibido no botão de página anterior.

Visible

Obtém ou define um valor que indica se os controles de paginação são exibidos em um controle que dá suporte à paginação.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Recupera a representação de cadeia de caracteres de um objeto PagerSettings.

Eventos

PropertyChanged

Ocorre quando uma propriedade de um objeto PagerSettings muda de valor.

Implantações explícitas de interface

IStateManager.IsTrackingViewState

Obtém um valor que indica se o controle de servidor está acompanhando as alterações de estado de exibição.

IStateManager.LoadViewState(Object)

Carrega o estado de exibição salvo anteriormente do objeto PagerSettings.

IStateManager.SaveViewState()

Salva o estado de exibição atual do objeto PagerSettings.

IStateManager.TrackViewState()

Marca o ponto inicial no qual começar a acompanhar e salvar as alterações de estado de exibição ao objeto PagerSettings.

Aplica-se a

Confira também