NumericPagerField Classe

Definição

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

Assemblagem:: System.Web.Extensions.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 um DataPager campo que permite aos utilizadores selecionar uma página pelo número da 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: Object

DataPagerField
NumericPagerField

Exemplos

O exemplo seguinte mostra como usar um NumericPagerField objeto para paginar dados que são exibidos num ListView 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 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>

Observações

A NumericPagerField classe apresenta os controlos de navegação num DataPager controlo. Os controlos podem ser usados para folhear dados que são exibidos por um controlo que implementa a IPageableItemContainer interface, como o controlo ListView . O NumericPagerField objeto mostra os números das páginas como botões que os utilizadores podem clicar para mover para uma página específica. O controlo também mostra os botões de página seguinte e página anterior que permitem aos utilizadores aceder a mais páginas de dados do que aquelas apresentadas pelo controlo.

Pode personalizar a aparência do NumericPagerField objeto usando as propriedades que estão listadas na tabela seguinte.

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

Pode usar a ButtonType propriedade para selecionar o tipo de botão que será exibido. A tabela seguinte lista os tipos de botões disponíveis.

Tipo de botão	Description
ButtonType.Button	Um Button controlo.
ButtonType.Image	Um ImageButton controlo.
ButtonType.Link	Um LinkButton controlo.

Os controlos dentro do NumericButtonCssClass objeto são renderizados com espaços ininterruptos entre eles. Se quiser personalizar este comportamento, pode usar a propriedade RenderNonBreakingSpacesBetweenControls .

Podes esconder um NumericPagerField objeto num DataPager controlo definindo a Visible propriedade para false. Não pode controlar a visibilidade dos botões da página seguinte e da página anterior. São exibidos pelo controlo se o controlo de dados associado tiver páginas adicionais disponíveis para exibir. Pode usar a ButtonCount propriedade para especificar quantos botões são exibidos num NumericPagerField objeto. Cada botão corresponde a um número de página.

Pode definir o texto do botão de página seguinte definindo a NextPageText propriedade. Pode definir o texto do botão da página anterior usando a PreviousPageText propriedade.

Quando a ButtonType propriedade está definida para ButtonType.Image, deve fornecer o URL de uma imagem que será exibida para os botões da página seguinte e da página anterior. Faz-se isto definindo as NextPageImageUrl propriedades e.PreviousPageImageUrl Nesse caso, a propriedade de texto correspondente é usada como texto alternativo para a imagem. Por exemplo, o texto especificado pela NextPageImageUrl propriedade é apresentado como texto alternativo para o botão da imagem da página seguinte. Em navegadores que suportam tooltips, este texto também é apresentado como tooltip para o botão correspondente.

Construtores

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

Propriedades

Name	Description
ButtonCount	Obtém ou define o número de botões a mostrar num NumericPagerField objeto.
ButtonType	Obtém ou define o tipo de botão para mostrar no campo do pager.
CurrentPageLabelCssClass	Recebe ou define a classe de folha de estilo em cascata (CSS) que é usada para estilizar o número de página atual.
DataPager	Obtém uma referência ao pager de dados ao qual o DataPagerField objeto está associado. (Herdado de DataPagerField)
IsTrackingViewState	Obtém um valor que indica se o DataPagerField objeto está a acompanhar as suas alterações no estado de visualização. (Herdado de DataPagerField)
NextPageImageUrl	Obtém ou define a URL de uma imagem que é exibida para o botão de página seguinte no NumericPagerField objeto.
NextPageText	Recebe ou define o texto que é mostrado para o botão de página seguinte.
NextPreviousButtonCssClass	Obtém ou define a classe de folha de estilo em cascata (CSS) que é usada para estilizar os botões da página seguinte e da página anterior do campo do pager.
NumericButtonCssClass	Recebe ou define a classe de folha de estilo em cascata (CSS) que é usada para estilizar os botões de número de página do campo do paginador.
PreviousPageImageUrl	Obtém ou define a URL de uma imagem que é exibida para o botão da página anterior no NumericPagerField objeto.
PreviousPageText	Obtém ou define o texto que é mostrado para o botão da página anterior.
QueryStringHandled	Recebe ou define um valor que indica se o campo da string de consulta foi avaliado. (Herdado de DataPagerField)
QueryStringValue	Obtém o valor do campo da string de consulta a partir da URL do pedido. (Herdado de DataPagerField)
RenderNonBreakingSpacesBetweenControls	Obtém ou define um valor que indica se espaços não quebrados serão renderizados entre controlos.
ViewState	Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um DataPagerField objeto através de múltiplos pedidos para a mesma página. (Herdado de DataPagerField)
Visible	Recebe ou define um valor que indica se um campo de paginação de dados é renderizado. (Herdado de DataPagerField)

Métodos

Name	Description
CloneField()	Cria uma cópia do objeto atual que é derivada de DataPagerField. (Herdado de DataPagerField)
CopyProperties(DataPagerField)	Copia as propriedades do objeto atual NumericPagerField para o objeto especificado DataPagerField .
CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)	Cria os controlos da interface de utilizador (UI) para o objeto campo do pager e adiciona-os ao contentor especificado.
CreateField()	Cria e devolve uma nova instância da NumericPagerField classe.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual NumericPagerField .
GetHashCode()	Serve como função de hash para a NumericPagerField classe.
GetQueryStringNavigateUrl(Int32)	Cria uma URL que contém um campo de cadeia de consulta com o número de página especificado. (Herdado de DataPagerField)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
HandleEvent(CommandEventArgs)	Trata dos eventos que ocorrem no NumericPagerField objeto e realiza a ação apropriada.
LoadViewState(Object)	Restaura a informação do estado de visualização que estava guardada anteriormente. (Herdado de DataPagerField)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
OnFieldChanged()	Eleva o `FieldChanged` evento. (Herdado de DataPagerField)
SaveViewState()	Guarda as alterações feitas ao DataPagerField estado de visualização do objeto. (Herdado de DataPagerField)
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)
TrackViewState()	Faz com que o DataPagerField objeto acompanhe alterações ao estado da sua vista para que possam ser armazenadas na propriedade do ViewState controlo e persistir entre pedidos para a mesma página. (Herdado de DataPagerField)

Implementações de Interface Explícita

Name	Description
IStateManager.IsTrackingViewState	Obtém um valor que indica se o DataPagerField objeto está a acompanhar as suas alterações no estado de visualização. (Herdado de DataPagerField)
IStateManager.LoadViewState(Object)	Restaura a informação do estado de visualização que estava guardada anteriormente. (Herdado de DataPagerField)
IStateManager.SaveViewState()	Guarda as alterações feitas ao DataPagerField estado de visualização do objeto. (Herdado de DataPagerField)
IStateManager.TrackViewState()	Faz com que o DataPagerField objeto acompanhe alterações ao estado da sua vista para que possam ser armazenadas na propriedade do ViewState controlo e persistir entre pedidos para a mesma página. (Herdado de DataPagerField)

Aplica-se a

Ver também

Comentários

Esta página foi útil?