PagerSettings Classe

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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: Object
PagerSettings

Atributos: TypeConverterAttribute

Implementações: IStateManager

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

Partilhar via