PagerSettings Classe

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 que dá suporte à 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 , 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.

Modo	Descrição
NextPrevious	Botões da página anterior e da próxima página.
NextPreviousFirstLast	Botões de página anterior, próxima página, primeira página e última -page.
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 , NextPrevious NextPreviousFirstLastou NumericFirstLast valor, você 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 para uma imagem a ser exibida para o botão de primeira página.
PreviousPageImageUrl	A URL para uma imagem a ser exibida para o botão de página anterior.
NextPageImageUrl	A URL para uma imagem a ser exibida para o botão da próxima página.
LastPageImageUrl	A URL para 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 Numeric valor ou NumericFirstLast , 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

Nome	Description
PagerSettings()	Inicializa uma nova instância da classe PagerSettings.

Propriedades

Nome	Description
FirstPageImageUrl	Obtém ou define a URL como uma imagem a ser exibida 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 como uma imagem a ser exibida 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 no qual exibir os controles de pager em um controle que dá suporte à paginação.
NextPageImageUrl	Obtém ou define a URL como uma imagem a ser exibida para o botão da próxima página.
NextPageText	Obtém ou define o texto a ser exibido para o botão da 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 Mode propriedade é definida como o valor ou NumericFirstLast o Numeric valor.
Position	Obtém ou define um valor que especifica o local em que o pager é exibido.
PreviousPageImageUrl	Obtém ou define a URL como uma imagem a ser exibida para o botão de página anterior.
PreviousPageText	Obtém ou define o texto a ser exibido para o 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

Nome	Description
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 Objectatual. (Herdado de Object)
ToString()	Recupera a representação de cadeia de caracteres de um PagerSettings objeto.

Eventos

Nome	Description
PropertyChanged	Ocorre quando uma propriedade de um PagerSettings objeto altera valores.

Implantações explícitas de interface

Nome	Description
IStateManager.IsTrackingViewState	Obtém um valor que indica se o controle do servidor está acompanhando suas alterações de estado de exibição.
IStateManager.LoadViewState(Object)	Carrega o estado de exibição salvo anteriormente do PagerSettings objeto.
IStateManager.SaveViewState()	Salva o estado de exibição atual do PagerSettings objeto.
IStateManager.TrackViewState()	Marca o ponto de partida no qual iniciar o acompanhamento e salvar as alterações de estado do modo de exibição no PagerSettings objeto.

Aplica-se a

Confira também

Comentários

Esta página foi útil?

Compartilhar via

PagerSettings Classe

Definição

Exemplos

Comentários

Construtores

Propriedades

Métodos

Eventos

Implantações explícitas de interface

Aplica-se a

Confira também

Comentários