PagerSettings Classe

Definição

Espaço de Nomes:: System.Web.UI.WebControls

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Representa as propriedades dos controlos de paginação num controlo que suporta paginação. Esta 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 seguinte demonstra como usar o PagerSettings objeto contido na PagerSettings propriedade para personalizar o texto dos botões que são exibidos na linha de pager de um GridView controlo.


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

Observações

Controlos que suportam paginação (como o GridView, DetailsView, e FormView controlos) podem mostrar um conjunto de controlos chamado pager que permite ao utilizador navegar pelas páginas dentro do controlo. A PagerSettings classe é usada por estes controlos para representar as propriedades do pager. Em geral, o PagerSettings objeto é armazenado na PagerSettings propriedade do controlo. Pode personalizar o pager definindo as propriedades do PagerSettings objeto.

O pager suporta vários modos de visualização diferentes. Para especificar o modo em que o pager deve ser exibido, defina a Mode propriedade. A tabela seguinte descreve os diferentes modos.

Mode	Description
NextPrevious	Botões para a página anterior e para a página seguinte.
NextPreviousFirstLast	Botões de página anterior, página seguinte, primeira página e última -page.
Numeric	Botões de ligação numerados para aceder diretamente às páginas.
NumericFirstLast	Botões de ligação numerada, primeira e última ligação.

Quando a Mode propriedade está definida para NextPrevious, NextPreviousFirstLast, ou NumericFirstLast valor, pode personalizar o texto dos botões não numéricos definindo as propriedades mostradas na tabela seguinte.

Property	Description
FirstPageText	Texto para o botão da primeira página.
PreviousPageText	Texto para o botão da página anterior.
NextPageText	Texto para o botão de página seguinte.
LastPageText	Texto para o botão da última página.

Como alternativa, pode também mostrar imagens para os botões não numéricos, definindo as propriedades conforme mostrado na tabela seguinte.

Property	Description
FirstPageImageUrl	O URL de uma imagem para mostrar no botão da primeira página.
PreviousPageImageUrl	O URL para uma imagem a mostrar para o botão da página anterior.
NextPageImageUrl	O URL de uma imagem para mostrar no botão de página seguinte.
LastPageImageUrl	O URL de uma imagem para mostrar no botão da última página.

Note

Quando uma propriedade de imagem é definida, a propriedade de texto correspondente atua como texto alternativo para a imagem. Por exemplo, quando a FirstPageImageUrl propriedade é definida, o texto especificado pela FirstPageText propriedade é apresentado como texto alternativo para a imagem. Nos navegadores que suportam ToolTips, este texto também é apresentado como uma ToolTip para o botão correspondente.

Quando a Mode propriedade está definida para o Numeric valor ou NumericFirstLast , pode especificar o número de botões de página a mostrar no pager definindo a PageButtonCount propriedade.

O pager pode ser exibido no topo, na parte inferior ou ambos no topo e na base de um controlo. Para especificar a posição do pager, defina a Position propriedade. Para mostrar ou esconder o pager, use a propriedade Visible .

Construtores

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

Propriedades

Name	Description
FirstPageImageUrl	Recebe ou define o URL para uma imagem para mostrar no botão da primeira página.
FirstPageText	Obtém ou define o texto para mostrar o botão da primeira página.
LastPageImageUrl	Obtém ou define o URL para uma imagem para mostrar no botão da última página.
LastPageText	Obtém ou define o texto para mostrar o botão da última página.
Mode	Obtém ou define o modo para exibir os controlos do pager num controlo que suporta paginação.
NextPageImageUrl	Obtém ou define o URL para uma imagem para mostrar no botão de página seguinte.
NextPageText	Obtém ou define o texto para mostrar o botão de página seguinte.
PageButtonCount	Obtém ou define o número de botões de página a serem exibidos no pager quando a Mode propriedade está definida para o Numeric valor ou NumericFirstLast .
Position	Recebe ou define um valor que especifica a localização onde o pager é exibido.
PreviousPageImageUrl	Obtém ou define o URL para uma imagem para mostrar no botão da página anterior.
PreviousPageText	Obtém ou define o texto para mostrar o botão da página anterior.
Visible	Recebe ou define um valor que indica se os controlos de paginação são exibidos num controlo que suporta paginação.

Métodos

Name	Description
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
ToString()	Recupera a representação da cadeia de um PagerSettings objeto.

evento

Name	Description
PropertyChanged	Ocorre quando uma propriedade de um PagerSettings objeto muda de valor.

Implementações de Interface Explícita

Name	Description
IStateManager.IsTrackingViewState	Recebe um valor que indica se o controlo do servidor está a acompanhar as alterações no estado da visualização.
IStateManager.LoadViewState(Object)	Carrega o estado de visualização previamente guardado do PagerSettings objeto.
IStateManager.SaveViewState()	Guarda o estado atual da vista do PagerSettings objeto.
IStateManager.TrackViewState()	Marca o ponto de partida a partir do qual se deve começar a registar e guardar as alterações de estado da vista do PagerSettings objeto.

Aplica-se a

Ver também

Comentários

Esta página foi útil?