NumericPagerField Classe

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.Extensions.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 um DataPager campo 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: Object

DataPagerField
NumericPagerField

Exemplos

O exemplo a seguir mostra como usar um NumericPagerField objeto para fazer a página 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 de página atual.
NextPreviousButtonCssClass	A classe CSS para os botões da próxima página e da 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 Button controle.
ButtonType.Image	Um ImageButton controle.
ButtonType.Link	Um LinkButton controle.

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 estiver definida como ButtonType.Image, você deverá fornecer a URL de uma imagem que será exibida para os botões de página seguinte e anterior. Você faz isso definindo as propriedades e PreviousPageImageUrl as NextPageImageUrl propriedades. 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 ferramentas, esse texto também é exibido como uma dica de ferramenta para o botão correspondente.

Construtores

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

Propriedades

Nome	Description
ButtonCount	Obtém ou define o número de botões a serem exibidos em um NumericPagerField objeto.
ButtonType	Obtém ou define o tipo de botão a ser exibido no campo pager.
CurrentPageLabelCssClass	Obtém ou define a classe CSS (folha de estilos em cascata) usada para definir o estilo do 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á acompanhando suas alterações de estado de exibição. (Herdado de DataPagerField)
NextPageImageUrl	Obtém ou define a URL de uma imagem exibida para o botão da próxima página no NumericPagerField objeto.
NextPageText	Obtém ou define o texto exibido para o botão da próxima página.
NextPreviousButtonCssClass	Obtém ou define a classe CSS (folha de estilos em cascata) usada para estilizar os botões da próxima página e da página anterior do campo 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 pager.
PreviousPageImageUrl	Obtém ou define a URL de uma imagem exibida para o botão de página anterior no NumericPagerField objeto.
PreviousPageText	Obtém ou define o texto exibido para o botão de página anterior.
QueryStringHandled	Obtém ou define um valor que indica se o campo de cadeia de caracteres de consulta foi avaliado. (Herdado de DataPagerField)
QueryStringValue	Obtém o valor do campo de cadeia de caracteres de consulta da URL da solicitação. (Herdado de DataPagerField)
RenderNonBreakingSpacesBetweenControls	Obtém ou define um valor que indica se espaços sem interrupção serão renderizados entre controles.
ViewState	Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um DataPagerField objeto 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 pager de dados é renderizado. (Herdado de DataPagerField)

Métodos

Nome	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 controles de 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 NumericPagerField classe.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual NumericPagerField .
GetHashCode()	Serve como uma função de hash para a NumericPagerField classe.
GetQueryStringNavigateUrl(Int32)	Cria uma URL que contém um campo de cadeia de caracteres 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 eventos que ocorrem no NumericPagerField objeto e executa a ação apropriada.
LoadViewState(Object)	Restaura informações de estado de exibição que foram salvas anteriormente. (Herdado de DataPagerField)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
OnFieldChanged()	Aciona o evento `FieldChanged`. (Herdado de DataPagerField)
SaveViewState()	Salva as alterações feitas no estado de exibição DataPagerField do objeto. (Herdado de DataPagerField)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TrackViewState()	Faz com que o DataPagerField objeto acompanhe as alterações em seu estado de exibição para que elas possam ser armazenadas na propriedade do ViewState controle e mantidas entre solicitações para a mesma página. (Herdado de DataPagerField)

Implantações explícitas de interface

Nome	Description
IStateManager.IsTrackingViewState	Obtém um valor que indica se o DataPagerField objeto está acompanhando suas alterações de estado de exibição. (Herdado de DataPagerField)
IStateManager.LoadViewState(Object)	Restaura informações de estado de exibição que foram salvas anteriormente. (Herdado de DataPagerField)
IStateManager.SaveViewState()	Salva as alterações feitas no estado de exibição DataPagerField do objeto. (Herdado de DataPagerField)
IStateManager.TrackViewState()	Faz com que o DataPagerField objeto acompanhe as alterações em seu estado de exibição para que elas possam ser armazenadas na propriedade do ViewState controle e mantidas entre solicitações para a mesma página. (Herdado de DataPagerField)

Aplica-se a

Confira também

Comentários

Esta página foi útil?

Compartilhar via

NumericPagerField Classe

Definição

Exemplos

Comentários

Construtores

Propriedades

Métodos

Implantações explícitas de interface

Aplica-se a

Confira também

Comentários