NextPreviousPagerField Classe
Definição
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 campo que mostra os controlos de navegação num DataPager controlo que permite aos utilizadores folhear 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 seguinte mostra como usar um NextPreviousPagerField 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>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>
Observações
A NextPreviousPagerField classe representa um campo que apresenta os controlos de navegação num DataPager controlo. Estes controlos de navegação podem ser usados para passar por dados que são exibidos por um controlo que implementa a IPageableItemContainer interface, como o controlo ListView .
A NextPreviousPagerField classe disponibiliza botões que permitem aos utilizadores navegar pelas páginas de dados uma página de cada vez, ou saltar para a primeira ou última página de dados.
Podes personalizar a aparência do NextPreviousPagerField objeto usando a ButtonCssClass propriedade para definir o estilo dos botões. Também pode usar a ButtonType propriedade para escolher o tipo de botão que é exibido. A tabela seguinte lista os tipos de botões disponíveis.
| Tipo de botão | Descrição |
|---|---|
| Button | Um Button controlo. |
| Image | Um ImageButton controlo. |
| Link | Um LinkButton controlo. |
Podes esconder um NextPreviousPagerField objeto num DataPager controlo definindo a Visible propriedade para false. Também pode esconder os botões individuais (a primeira página, a página anterior, a página seguinte e a última página) definindo , ShowFirstPageButtonShowPreviousPageButton, ShowNextPageButton, e ShowLastPageButton propriedades para false.
O NextPreviousPagerField controlo permite-lhe especificar texto personalizado para cada botão usando , FirstPageTextPreviousPageText, NextPageText, e LastPageText propriedades.
Quando a ButtonType propriedade está definida para ButtonType.Image, deve fornecer a URL de uma imagem que será exibida para o botão. Pode definir imagens individualmente para cada botão definindo , FirstPageImageUrlPreviousPageImageUrl, NextPageImageUrl, e LastPageImageUrl propriedades.
Quando a ButtonType propriedade é definida para ButtonType.Image, a propriedade correspondente do texto atua como texto alternativo para a imagem. Por exemplo, o texto especificado pela FirstPageText propriedade é apresentado como texto alternativo para o botão da imagem da primeira página. Em navegadores que suportam tooltips, este texto também é apresentado como tooltip.
Construtores
| Name | Description |
|---|---|
| NextPreviousPagerField() |
Inicializa uma nova instância da NextPreviousPagerField classe. |
Propriedades
| Name | Description |
|---|---|
| ButtonCssClass |
Obtém ou define a classe de folha de estilo em cascata (CSS) que é usada para renderizar os botões do campo pager no navegador. |
| ButtonType |
Obtém ou define o tipo de botão para mostrar no campo do pager. |
| DataPager |
Obtém uma referência ao pager de dados ao qual o DataPagerField objeto está associado. (Herdado de DataPagerField) |
| FirstPageImageUrl |
Obtém ou define a URL para uma imagem que é mostrada para o botão da primeira página. |
| FirstPageText |
Recebe ou define o texto que é mostrado para o botão da primeira página. |
| 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) |
| LastPageImageUrl |
Obtém ou define a URL para uma imagem que é exibida para o botão de última página no NextPreviousPagerField objeto. |
| LastPageText |
Obtém ou define o texto que é mostrado para o botão da última página. |
| NextPageImageUrl |
Obtém ou define a URL para uma imagem que é exibida para o botão de página seguinte no NextPreviousPagerField objeto. |
| NextPageText |
Recebe ou define o texto que é mostrado para o botão de página seguinte. |
| PreviousPageImageUrl |
Obtém ou define a URL para uma imagem que é exibida para o botão da página anterior no NextPreviousPagerField 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) |
| RenderDisabledButtonsAsLabels |
Recebe ou define um valor que indica se os botões desativados são renderizados como Label controlos pelo NextPreviousPagerField objeto. |
| RenderNonBreakingSpacesBetweenControls |
Recebe ou define um valor que indica se espaços sem interrupção são renderizados entre controlos. |
| ShowFirstPageButton |
Recebe ou define um valor que indica se o botão de primeira página é exibido num NextPreviousPagerField objeto. |
| ShowLastPageButton |
Recebe ou define um valor que indica se o botão de última página é exibido num NextPreviousPagerField objeto. |
| ShowNextPageButton |
Recebe ou define um valor que indica se o botão de página seguinte é exibido num NextPreviousPagerField objeto. |
| ShowPreviousPageButton |
Recebe ou define um valor que indica se o botão da página anterior está apresentado num NextPreviousPagerField objeto. |
| 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 NextPreviousPagerField 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 NextPreviousPagerField classe. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual NextPreviousPagerField . |
| GetHashCode() |
Serve como função de hash para a NextPreviousPagerField 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) |
Lida com os eventos que ocorrem no NextPreviousPagerField controlo e executa 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 |
| 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) |
