PagerSettings.Mode Propriedade

Definição

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

Obtém ou define o modo para exibir os controlos do pager num controlo que suporta paginação.

public:
 property System::Web::UI::WebControls::PagerButtons Mode { System::Web::UI::WebControls::PagerButtons get(); void set(System::Web::UI::WebControls::PagerButtons value); };
public System.Web.UI.WebControls.PagerButtons Mode { get; set; }
member this.Mode : System.Web.UI.WebControls.PagerButtons with get, set
Public Property Mode As PagerButtons

Valor de Propriedade

PagerButtons

Um dos PagerButtons valores. A predefinição é PagerButtons.Numeric.

Exceções

ArgumentOutOfRangeException

O Mode é definido para um valor que não é um dos PagerButtons valores.

Exemplos

O exemplo de código seguinte demonstra como usar a Mode propriedade para especificar que a linha do pager para um GridView controlo deve mostrar botões numéricos.


<%@ 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="NumericFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            pagebuttoncount="5"  
            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="NumericFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            pagebuttoncount="5"  
            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

Os controlos que suportam paginação fornecem múltiplos modos para exibir os controlos de paginação. Use a Mode propriedade para especificar o modo. A tabela seguinte descreve os diferentes modos de controlo de paginação.

Mode Descrição
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 página.
Numeric Botões de ligação numerados para aceder diretamente às páginas.
NumericFirstLast Botões numerados, de primeiro e último elo de ligação.

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

Property Descrição
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 apresentadas na tabela seguinte.

Property Descrição
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.

O valor desta propriedade é armazenado no estado de visualização.

Aplica-se a

Ver também