NextPreviousPagerField Classe

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.Extensions.dll

Representa um campo que exibe controles de navegação em um controle DataPager que permite que os usuários naveguem pelos dados.

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

Exemplos

O exemplo a seguir mostra como usar um NextPreviousPagerField 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>NextPreviousPagerField Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NextPreviousPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="ContactIDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td>
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <asp:DataPager runat="server" ID="ContactsDataPager" PagedControlID="ContactsListView">
        <Fields>
          <asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true" />
        </Fields>
      </asp:DataPager>

      <!-- 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>NextPreviousPagerField Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NextPreviousPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="ContactIDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td>
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <asp:DataPager runat="server" ID="ContactsDataPager" PagedControlID="ContactsListView">
        <Fields>
          <asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true" />
        </Fields>
      </asp:DataPager>

      <!-- 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 NextPreviousPagerField classe representa um campo que exibe controles de navegação em um DataPager controle . Esses controles de navegação podem ser usados para percorrer dados exibidos por um controle que implementa a IPageableItemContainer interface, como o ListView controle .

A NextPreviousPagerField classe fornece botões que permitem que os usuários naveguem pelas páginas de dados uma página de cada vez ou pulem para a primeira ou última página de dados.

Você pode personalizar a aparência do NextPreviousPagerField objeto usando a ButtonCssClass propriedade para definir o estilo dos botões. Você também pode usar a ButtonType propriedade para escolher o tipo de botão exibido. A tabela a seguir lista os tipos de botão disponíveis.

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

Você pode ocultar um NextPreviousPagerField objeto em um DataPager controle definindo a Visible propriedade falsecomo . Você também pode ocultar os botões individuais (os botões de primeira página, página anterior, próxima página e última página) definindo as ShowFirstPageButtonpropriedades , ShowPreviousPageButtonShowNextPageButton, e ShowLastPageButton como false.

O NextPreviousPagerField controle permite que você especifique texto personalizado para cada botão usando as FirstPageTextpropriedades , PreviousPageText, NextPageTexte LastPageText .

Quando a ButtonType propriedade é definida ButtonType.Imagecomo , você deve fornecer a URL para uma imagem que será exibida para o botão. Você pode definir imagens individualmente para cada botão definindo as FirstPageImageUrlpropriedades , PreviousPageImageUrl, NextPageImageUrle LastPageImageUrl .

Quando a ButtonType propriedade é definida ButtonType.Imagecomo , a propriedade de texto correspondente atua como o texto alternativo para a imagem. Por exemplo, o texto especificado pela FirstPageText propriedade é exibido como o texto alternativo para o botão de imagem da primeira página. Em navegadores que dão suporte a dicas de ferramenta, esse texto também é exibido como uma dica de ferramenta.

Construtores

NextPreviousPagerField()

Inicializa uma nova instância da classe NextPreviousPagerField.

Propriedades

ButtonCssClass

Obtém ou define a classe CSS (folha de estilos em cascata) que é usada para renderizar os botões de campo de pager no navegador.
ButtonType

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

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

(Herdado de DataPagerField)
FirstPageImageUrl

Obtém ou define a URL para uma imagem exibida para o botão de primeira página.
FirstPageText

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

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

(Herdado de DataPagerField)
LastPageImageUrl

Obtém ou define a URL para uma imagem exibida no botão de última página no objeto NextPreviousPagerField.
LastPageText

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

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

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

Obtém ou define a URL para uma imagem exibida no botão de página anterior no objeto NextPreviousPagerField.
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)
RenderDisabledButtonsAsLabels

Obtém ou define um valor que indica se os botões desabilitados são renderizados como controles Label pelo objeto NextPreviousPagerField.
RenderNonBreakingSpacesBetweenControls

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

Obtém ou define um valor que indica se o botão de primeira página é exibido em um objeto NextPreviousPagerField.
ShowLastPageButton

Obtém ou define um valor que indica se o botão de última página é exibido em um objeto NextPreviousPagerField.
ShowNextPageButton

Obtém ou define um valor que indica se o botão de próxima página é exibido em um objeto NextPreviousPagerField.
ShowPreviousPageButton

Obtém ou define um valor que indica se o botão de página anterior é exibido em um objeto NextPreviousPagerField.
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 NextPreviousPagerField 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 NextPreviousPagerField.
Equals(Object)

Determina se o objeto especificado é igual ao objeto NextPreviousPagerField atual.
GetHashCode()

Serve como uma função hash para a classe NextPreviousPagerField.
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)

Trata os eventos que ocorrem no controle NextPreviousPagerField 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