NumericPagerField Classe

Referência

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 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: Object

DataPagerField
NumericPagerField

Exemplos

O exemplo a seguir mostra como usar um NumericPagerField objeto para percorrer os 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 percorrer 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 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 do número da 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 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 falsecomo . Você não pode 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 for definida ButtonType.Imagecomo , você deverá fornecer a URL de uma imagem que será exibida para os botões da 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

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

Recursos adicionais