NumericPagerField Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta un campo DataPager che consente agli utenti di selezionare un numero di pagina per pagina.
public ref class NumericPagerField : System::Web::UI::WebControls::DataPagerFieldpublic class NumericPagerField : System.Web.UI.WebControls.DataPagerFieldtype NumericPagerField = class
inherit DataPagerFieldPublic Class NumericPagerField
Inherits DataPagerField- Ereditarietà
Esempio
Nell'esempio seguente viene illustrato come utilizzare un NumericPagerField oggetto per scorrere i dati visualizzati in un ListView controllo .
<%@ 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>
Commenti
La NumericPagerField classe visualizza i controlli di spostamento in un DataPager controllo . I controlli possono essere utilizzati per scorrere i dati visualizzati da un controllo che implementa l'interfaccia IPageableItemContainer , ad esempio il ListView controllo . L'oggetto NumericPagerField visualizza i numeri di pagina come pulsanti che gli utenti possono fare clic per passare a una pagina specifica. Il controllo visualizza anche i pulsanti pagina successiva e pagina precedente che consentono agli utenti di accedere a più pagine di dati rispetto a quelle visualizzate dal controllo.
È possibile personalizzare l'aspetto dell'oggetto NumericPagerField usando le proprietà elencate nella tabella seguente.
| Proprietà | Descrizione |
|---|---|
| CurrentPageLabelCssClass | Classe CSS per il numero di pagina corrente. |
| NextPreviousButtonCssClass | Classe CSS per i pulsanti pagina successiva e pagina precedente. |
| NumericButtonCssClass | Classe CSS per i pulsanti che rappresentano i numeri di pagina. |
È possibile utilizzare la ButtonType proprietà per selezionare il tipo di pulsante che verrà visualizzato. Nella tabella seguente sono elencati i tipi di pulsante disponibili.
| Tipo | Descrizione |
|---|---|
| ButtonType.Button | Controllo Button. |
| ButtonType.Image | Controllo ImageButton. |
| ButtonType.Link | Controllo LinkButton. |
Il rendering dei controlli all'interno dell'oggetto NumericButtonCssClass viene eseguito con spazi non di rilievo tra di essi. Se si vuole personalizzare questo comportamento, è possibile usare la RenderNonBreakingSpacesBetweenControls proprietà .
È possibile nascondere un NumericPagerField oggetto in un DataPager controllo impostando la Visible proprietà su false. Non è possibile controllare la visibilità dei pulsanti pagina successiva e pagina precedente. Vengono visualizzati dal controllo se il controllo dati associato dispone di pagine aggiuntive disponibili per la visualizzazione. È possibile utilizzare la ButtonCount proprietà per specificare il numero di pulsanti visualizzati in un NumericPagerField oggetto . Ogni pulsante corrisponde a un numero di pagina.
È possibile impostare il testo del pulsante pagina successiva impostando la NextPageText proprietà . È possibile impostare il testo del pulsante della pagina precedente usando la PreviousPageText proprietà .
Quando la ButtonType proprietà è impostata su ButtonType.Image, è necessario specificare l'URL di un'immagine che verrà visualizzata per i pulsanti pagina successiva e pagina precedente. A tale scopo, impostare le NextPageImageUrl proprietà e PreviousPageImageUrl . In tal caso, la proprietà di testo corrispondente viene utilizzata come testo alternativo per l'immagine. Ad esempio, il testo specificato dalla NextPageImageUrl proprietà viene visualizzato come testo alternativo per il pulsante immagine di pagina successiva. Nei browser che supportano le descrizioni comando, questo testo viene visualizzato anche come descrizione comando per il pulsante corrispondente.
Costruttori
| NumericPagerField() |
Inizializza una nuova istanza della classe NumericPagerField. |
Proprietà
| ButtonCount |
Ottiene o imposta il numero di pulsanti da visualizzare in un oggetto NumericPagerField. |
| ButtonType |
Ottiene o imposta il tipo di pulsante da visualizzare nel campo del pager. |
| CurrentPageLabelCssClass |
Ottiene o imposta la classe del foglio di stile CSS utilizzata per definire lo stile del numero di pagina corrente. |
| DataPager |
Ottiene un riferimento al pager di dati a cui l'oggetto DataPagerField è associato. (Ereditato da DataPagerField) |
| IsTrackingViewState |
Ottiene un valore che indica se l'oggetto DataPagerField tiene traccia delle modifiche apportate al relativo stato di visualizzazione. (Ereditato da DataPagerField) |
| NextPageImageUrl |
Ottiene o imposta l'URL di un'immagine visualizzata per il pulsante Pagina successiva nell'oggetto NumericPagerField. |
| NextPageText |
Ottiene o imposta il testo visualizzato per il pulsante relativo alla pagina successiva. |
| NextPreviousButtonCssClass |
Ottiene o imposta la classe del foglio di stile CSS utilizzata per definire lo stile dei pulsanti Pagina successiva e Pagina precedente del campo del pager. |
| NumericButtonCssClass |
Ottiene o imposta la classe del foglio di stile CSS utilizzata per definire lo stile dei pulsanti relativi ai numeri di pagina del campo del pager. |
| PreviousPageImageUrl |
Ottiene o imposta l'URL di un'immagine visualizzata per il pulsante Pagina precedente nell'oggetto NumericPagerField. |
| PreviousPageText |
Ottiene o imposta il testo visualizzato per il pulsante relativo alla pagina precedente. |
| QueryStringHandled |
Ottiene o imposta un valore che indica se il campo della stringa di query è stato valutato. (Ereditato da DataPagerField) |
| QueryStringValue |
Ottiene il valore del campo della stringa di query dall'URL della richiesta. (Ereditato da DataPagerField) |
| RenderNonBreakingSpacesBetweenControls |
Ottiene o imposta un valore che indica se gli spazi unificatori verranno sottoposti a rendering tra i controlli. |
| ViewState |
Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un oggetto DataPagerField tra più richieste per la stessa pagina. (Ereditato da DataPagerField) |
| Visible |
Ottiene o imposta un valore che indica se viene eseguito il rendering di un campo del pager di dati. (Ereditato da DataPagerField) |
Metodi
| CloneField() |
Crea una copia dell'oggetto corrente derivato da DataPagerField. (Ereditato da DataPagerField) |
| CopyProperties(DataPagerField) |
Copia le proprietà dell'oggetto NumericPagerField corrente nell'oggetto DataPagerField specificato. |
| CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32) |
Crea i controlli dell'interfaccia utente per l'oggetto campo del pager e li aggiunge al contenitore specificato. |
| CreateField() |
Crea e restituisce una nuova istanza della classe NumericPagerField. |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto NumericPagerField corrente. |
| GetHashCode() |
Viene utilizzato come funzione hash per la classe NumericPagerField. |
| GetQueryStringNavigateUrl(Int32) |
Crea un URL che contiene un campo della stringa di query con il numero di pagina specificato. (Ereditato da DataPagerField) |
| GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
| HandleEvent(CommandEventArgs) |
Gestisce gli eventi che si verificano nell'oggetto NumericPagerField ed esegue l'azione appropriata. |
| LoadViewState(Object) |
Ripristina informazioni sullo stato di visualizzazione salvate in precedenza. (Ereditato da DataPagerField) |
| MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
| OnFieldChanged() |
Genera l'evento |
| SaveViewState() |
Salva le modifiche apportate allo stato di visualizzazione dell'oggetto DataPagerField. (Ereditato da DataPagerField) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
| TrackViewState() |
Determina la registrazione da parte dell'oggetto DataPagerField delle modifiche apportate al relativo stato di visualizzazione per consentirne l'archiviazione nella proprietà ViewState del controllo e la conservazione nelle richieste relative alla stessa pagina. (Ereditato da DataPagerField) |
Implementazioni dell'interfaccia esplicita
| IStateManager.IsTrackingViewState |
Ottiene un valore che indica se l'oggetto DataPagerField tiene traccia delle modifiche apportate al relativo stato di visualizzazione. (Ereditato da DataPagerField) |
| IStateManager.LoadViewState(Object) |
Ripristina informazioni sullo stato di visualizzazione salvate in precedenza. (Ereditato da DataPagerField) |
| IStateManager.SaveViewState() |
Salva le modifiche apportate allo stato di visualizzazione dell'oggetto DataPagerField. (Ereditato da DataPagerField) |
| IStateManager.TrackViewState() |
Determina la registrazione da parte dell'oggetto DataPagerField delle modifiche apportate al relativo stato di visualizzazione per consentirne l'archiviazione nella proprietà ViewState del controllo e la conservazione nelle richieste relative alla stessa pagina. (Ereditato da DataPagerField) |
