Partilhar via


NumericPagerField Classe

Definição

Representa um campo de DataPager que permite que os usuários selecionem uma página por número de página.

public ref class NumericPagerField : System::Web::UI::WebControls::DataPagerField
public class NumericPagerField : System.Web.UI.WebControls.DataPagerField
type NumericPagerField = class
    inherit DataPagerField
Public Class NumericPagerField
Inherits DataPagerField
Herança
NumericPagerField

Exemplos

O exemplo a seguir mostra como usar um NumericPagerField objeto para paginar por meio de dados exibidos em um ListView 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 id="Head1" runat="server">
    <title>NumericPagerField Example</title>    
    <style type="text/css">
      body 	
      {
        text-align: center;
        font: 12px Arial, Helvetica, sans-serif;
      } 
      table
      {
        padding: 2px 2px 2px 2px;
        border: 1px solid;
        width: 500px;
      }     
      .CurrentPage 
      {
        padding: 2px 6px;
        border: solid 1px #ddd; 
        background: #2E8B57;
        color:White;
      }
      .PrevNext,.PageNumber
      {
        padding: 2px 6px;
        border: solid 1px #ddd;
        text-decoration: none;
        color: #2E8B57;
      }
      .PageNumber:hover, .PrevNext:hover
      {
        background-color: #FFA500;
        color: White;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NumericPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td align="left">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("LastName") + ", " + Eval("FirstName")%>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>
      <br />

      <div>
        <asp:DataPager runat="server" 
          ID="ContactsDataPager" 
          PagedControlID="ContactsListView">
          <Fields>
            <asp:NumericPagerField 
              PreviousPageText="< Prev"
              NextPageText="Next >"
              ButtonCount="10"
              NextPreviousButtonCssClass="PrevNext"
              CurrentPageLabelCssClass="CurrentPage"
              NumericButtonCssClass="PageNumber" />
          </Fields>
        </asp:DataPager>
      </div>
      <br />

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [ContactID], [FirstName], [LastName] 
          FROM Person.Contact">
      </asp:SqlDataSource>
      
    </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 id="Head1" runat="server">
    <title>NumericPagerField Example</title>    
    <style type="text/css">
      body 	
      {
        text-align: center;
        font: 12px Arial, Helvetica, sans-serif;
      } 
      table
      {
        padding: 2px 2px 2px 2px;
        border: 1px solid;
        width: 500px;
      }     
      .CurrentPage 
      {
        padding: 2px 6px;
        border: solid 1px #ddd; 
        background: #2E8B57;
        color:White;
      }
      .PrevNext,.PageNumber
      {
        padding: 2px 6px;
        border: solid 1px #ddd;
        text-decoration: none;
        color: #2E8B57;
      }
      .PageNumber:hover, .PrevNext:hover
      {
        background-color: #FFA500;
        color: White;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NumericPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td align="left">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("LastName") & ", " & Eval("FirstName")%>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>
      <br />

      <div>
        <asp:DataPager runat="server" 
          ID="ContactsDataPager" 
          PagedControlID="ContactsListView">
          <Fields>
            <asp:NumericPagerField 
              PreviousPageText="< Prev"
              NextPageText="Next >"
              ButtonCount="10"
              NextPreviousButtonCssClass="PrevNext"
              CurrentPageLabelCssClass="CurrentPage"
              NumericButtonCssClass="PageNumber" />
          </Fields>
        </asp:DataPager>
      </div>
      <br />

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [ContactID], [FirstName], [LastName] 
          FROM Person.Contact">
      </asp:SqlDataSource>
      
    </form>
  </body>
</html>

Comentários

A NumericPagerField classe exibe controles de navegação em um DataPager controle . Os controles podem ser usados para usar a página por meio de dados exibidos por um controle que implementa a IPageableItemContainer interface, como o ListView controle . O NumericPagerField objeto exibe números de página como botões que os usuários podem clicar para mover para uma página específica. O controle também exibe botões de página seguinte e de página anterior que permitem que os usuários acessem mais páginas de dados do que aquelas exibidas pelo controle.

Você pode personalizar a aparência do NumericPagerField objeto usando as propriedades listadas na tabela a seguir.

Propriedade Descrição
CurrentPageLabelCssClass A classe CSS para o número da página atual.
NextPreviousButtonCssClass A classe CSS para os botões de página seguinte e de página anterior.
NumericButtonCssClass A classe CSS para os botões que representam os números de página.

Você pode usar a ButtonType propriedade para selecionar o tipo de botão que será exibido. A tabela a seguir lista os tipos de botão disponíveis.

Tipo de botão Descrição
ButtonType.Button Um controle Button.
ButtonType.Image Um controle ImageButton.
ButtonType.Link Um controle LinkButton.

Os controles dentro do NumericButtonCssClass objeto são renderizados com espaços sem interrupção entre eles. Se você quiser personalizar esse comportamento, poderá usar a RenderNonBreakingSpacesBetweenControls propriedade .

Você pode ocultar um NumericPagerField objeto em um DataPager controle definindo a Visible propriedade como false. Não é possível controlar a visibilidade dos botões da próxima página e da página anterior. Eles serão exibidos pelo controle se o controle de dados associado tiver páginas adicionais disponíveis para exibição. Você pode usar a ButtonCount propriedade para especificar quantos botões são exibidos em um NumericPagerField objeto . Cada botão corresponde a um número de página.

Você pode definir o texto do botão da próxima página definindo a NextPageText propriedade . Você pode definir o texto do botão de página anterior usando a PreviousPageText propriedade .

Quando a ButtonType propriedade é definida como ButtonType.Image, você deve fornecer a URL de uma imagem que será exibida para os botões de página seguinte e anterior. Faça isso definindo as NextPageImageUrl propriedades e PreviousPageImageUrl . Nesse caso, a propriedade de texto correspondente é usada como o texto alternativo para a imagem. Por exemplo, o texto especificado pela NextPageImageUrl propriedade é exibido como o texto alternativo para o botão de imagem da próxima página. Em navegadores que dão suporte a dicas de ferramenta, esse texto também é exibido como uma dica de ferramenta para o botão correspondente.

Construtores

NumericPagerField()

Inicializa uma nova instância da classe NumericPagerField.

Propriedades

ButtonCount

Obtém ou define o número de botões a serem exibidos em um objeto NumericPagerField.

ButtonType

Obtém ou define o tipo de botão a exibir no campo do pager.

CurrentPageLabelCssClass

Obtém ou define a classe CSS (folha de estilos em cascata) usada para definir o estilo do número da página atual.

DataPager

Obtém uma referência à paginação de dados ao qual o objeto DataPagerField está associado.

(Herdado de DataPagerField)
IsTrackingViewState

Obtém um valor que indica se o objeto DataPagerField está controlando suas alterações de estado de exibição.

(Herdado de DataPagerField)
NextPageImageUrl

Obtém ou define a URL de uma imagem exibida no botão de próxima página no objeto NumericPagerField.

NextPageText

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

NextPreviousButtonCssClass

Obtém ou define a classe CSS (folha de estilos em cascata) usada para estilizar os botões próxima página e página anterior do campo do pager.

NumericButtonCssClass

Obtém ou define a classe CSS (folha de estilos em cascata) usada para estilizar os botões de número de página do campo de paginação.

PreviousPageImageUrl

Obtém ou define a URL de uma imagem exibida no botão de página anterior no objeto NumericPagerField.

PreviousPageText

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

QueryStringHandled

Obtém ou define um valor que indica se o campo da cadeia de consulta foi avaliado.

(Herdado de DataPagerField)
QueryStringValue

Obtém o valor do campo de cadeia de consulta da URL da solicitação.

(Herdado de DataPagerField)
RenderNonBreakingSpacesBetweenControls

Obtém ou define um valor que indica se os espaços não separáveis serão renderizados entre os controles.

ViewState

Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um objeto DataPagerField em várias solicitações para a mesma página.

(Herdado de DataPagerField)
Visible

Obtém ou define um valor que indica se um campo de paginação de dados é renderizado.

(Herdado de DataPagerField)

Métodos

CloneField()

Cria uma cópia do objeto atual derivada de DataPagerField.

(Herdado de DataPagerField)
CopyProperties(DataPagerField)

Copia as propriedades do objeto NumericPagerField atual para o objeto DataPagerField especificado.

CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)

Cria os controles da interface do usuário para o objeto de campo do pager e os adiciona ao contêiner especificado.

CreateField()

Cria e retorna uma nova instância da classe NumericPagerField.

Equals(Object)

Determina se o objeto especificado é igual ao objeto NumericPagerField atual.

GetHashCode()

Serve como uma função hash para a classe NumericPagerField.

GetQueryStringNavigateUrl(Int32)

Cria uma URL que contém um campo de cadeia de consulta que tem o número de página especificado.

(Herdado de DataPagerField)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
HandleEvent(CommandEventArgs)

Manipula os eventos que ocorrem no objeto NumericPagerField e executa a ação apropriada.

LoadViewState(Object)

Restaura as informações de estado de exibição salvas anteriormente.

(Herdado de DataPagerField)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
OnFieldChanged()

Aciona o evento FieldChanged.

(Herdado de DataPagerField)
SaveViewState()

Salva as alterações feitas ao estado de exibição do objeto DataPagerField.

(Herdado de DataPagerField)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
TrackViewState()

Faz com que o objeto DataPagerField controle as alterações em seu estado de exibição, de modo que elas possam ser armazenadas na propriedade ViewState do controle e persistidas entre solicitações para a mesma página.

(Herdado de DataPagerField)

Implantações explícitas de interface

IStateManager.IsTrackingViewState

Obtém um valor que indica se o objeto DataPagerField está controlando suas alterações de estado de exibição.

(Herdado de DataPagerField)
IStateManager.LoadViewState(Object)

Restaura as informações de estado de exibição salvas anteriormente.

(Herdado de DataPagerField)
IStateManager.SaveViewState()

Salva as alterações feitas ao estado de exibição do objeto DataPagerField.

(Herdado de DataPagerField)
IStateManager.TrackViewState()

Faz com que o objeto DataPagerField controle as alterações em seu estado de exibição, de modo que elas possam ser armazenadas na propriedade ViewState do controle e persistidas entre solicitações para a mesma página.

(Herdado de DataPagerField)

Aplica-se a

Confira também