NumericPagerField 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 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::DataPagerFieldpublic class NumericPagerField : System.Web.UI.WebControls.DataPagerFieldtype NumericPagerField = class
inherit DataPagerFieldPublic Class NumericPagerField
Inherits DataPagerField- Herança
Exemplos
O exemplo a seguir mostra como usar um NumericPagerField objeto para paginar 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 da página atual. |
| NextPreviousButtonCssClass | A classe CSS para os botões de página seguinte e de 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 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 é definida como ButtonType.Image, você deve fornecer a URL de uma imagem que será exibida para os botões de 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 |
| 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) |
