NextPreviousPagerField Classe
Definição
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 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::DataPagerFieldpublic class NextPreviousPagerField : System.Web.UI.WebControls.DataPagerFieldtype NextPreviousPagerField = class
inherit DataPagerFieldPublic Class NextPreviousPagerField
Inherits DataPagerField- Herança
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 |
| 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) |
