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 DataPager campo che consente agli utenti di selezionare una pagina in base al numero di 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 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 di pulsante | 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 desidera personalizzare questo comportamento, è possibile utilizzare 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 da visualizzare. È 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
| Nome | Descrizione |
|---|---|
| NumericPagerField() |
Inizializza una nuova istanza della classe NumericPagerField. |
Proprietà
| Nome | Descrizione |
|---|---|
| ButtonCount |
Ottiene o imposta il numero di pulsanti da visualizzare in un NumericPagerField oggetto . |
| ButtonType |
Ottiene o imposta il tipo di pulsante da visualizzare nel campo cercapersone. |
| CurrentPageLabelCssClass |
Ottiene o imposta la classe CSS (Cascading Style Sheet) utilizzata per applicare uno stile al numero di pagina corrente. |
| DataPager |
Ottiene un riferimento al cercapersone dati a cui è associato l'oggetto DataPagerField . (Ereditato da DataPagerField) |
| IsTrackingViewState |
Ottiene un valore che indica se l'oggetto DataPagerField sta monitorando le modifiche dello 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 pagina successiva. |
| NextPreviousButtonCssClass |
Ottiene o imposta la classe CSS (Cascading Style Sheet) utilizzata per applicare stili ai pulsanti pagina successiva e pagina precedente del campo cercapersone. |
| NumericButtonCssClass |
Ottiene o imposta la classe CSS (Cascading Style Sheet) utilizzata per applicare uno stile ai pulsanti del numero di pagina del campo del cercapersone. |
| 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 della 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 verrà eseguito il rendering di spazi non di rilievo tra i controlli. |
| ViewState |
Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un DataPagerField oggetto in 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 cercapersone dati. (Ereditato da DataPagerField) |
Metodi
| Nome | Descrizione |
|---|---|
| CloneField() |
Crea una copia dell'oggetto corrente derivato da DataPagerField. (Ereditato da DataPagerField) |
| CopyProperties(DataPagerField) |
Copia le proprietà dell'oggetto corrente NumericPagerField nell'oggetto specificato DataPagerField . |
| CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32) |
Crea i controlli dell'interfaccia utente per l'oggetto campo cercapersone e li aggiunge al contenitore specificato. |
| CreateField() |
Crea e restituisce una nuova istanza della NumericPagerField classe . |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente NumericPagerField . |
| GetHashCode() |
Funge da funzione hash per la NumericPagerField classe . |
| GetQueryStringNavigateUrl(Int32) |
Crea un URL contenente un campo stringa di query con il numero di pagina specificato. (Ereditato da DataPagerField) |
| GetType() |
Ottiene il 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 le informazioni sullo stato di visualizzazione salvate in precedenza. (Ereditato da DataPagerField) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| OnFieldChanged() |
Genera l'evento |
| SaveViewState() |
Salva le modifiche apportate allo DataPagerField stato di visualizzazione dell'oggetto. (Ereditato da DataPagerField) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
| TrackViewState() |
Fa in modo che l'oggetto DataPagerField possa tenere traccia delle modifiche apportate allo stato di visualizzazione in modo che possano essere archiviate nella proprietà del ViewState controllo e mantenute tra le richieste per la stessa pagina. (Ereditato da DataPagerField) |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| IStateManager.IsTrackingViewState |
Ottiene un valore che indica se l'oggetto DataPagerField sta monitorando le modifiche dello stato di visualizzazione. (Ereditato da DataPagerField) |
| IStateManager.LoadViewState(Object) |
Ripristina le informazioni sullo stato di visualizzazione salvate in precedenza. (Ereditato da DataPagerField) |
| IStateManager.SaveViewState() |
Salva le modifiche apportate allo DataPagerField stato di visualizzazione dell'oggetto. (Ereditato da DataPagerField) |
| IStateManager.TrackViewState() |
Fa in modo che l'oggetto DataPagerField possa tenere traccia delle modifiche apportate allo stato di visualizzazione in modo che possano essere archiviate nella proprietà del ViewState controllo e mantenute tra le richieste per la stessa pagina. (Ereditato da DataPagerField) |
