Classe NumericPagerField (System.Web.UI.WebControls)

Cambia visualizzazione:
Classica
Lightweight
ScriptFree
Riferimento a .NET Framework
Classe NumericPagerField
Il presente articolo è stato tradotto manualmente. Per visualizzare questa pagina e contemporaneamente visualizzarne il contenuto in lingua inglese, passare alla visualizzazione semplificata.

Rappresenta un campo DataPager che consente agli utenti di selezionare una pagina in base al numero di pagina.

Gerarchia di ereditarietà
System.Object
  System.Web.UI.WebControls.DataPagerField
    System.Web.UI.WebControls.NumericPagerField

Spazio dei nomi:  System.Web.UI.WebControls
Assembly:  System.Web.Extensions (in System.Web.Extensions.dll)
Sintassi
Visual Basic
Public Class NumericPagerField _
	Inherits DataPagerField
C#
public class NumericPagerField : DataPagerField
Visual C++
public ref class NumericPagerField : public DataPagerField
F#
type NumericPagerField =  
    class
        inherit DataPagerField
    end

Il tipo NumericPagerField espone i seguenti membri.

Costruttori
  Nome Descrizione
Metodo pubblico NumericPagerField Inizializza una nuova istanza della classe NumericPagerField.
In alto
Proprietà
  Nome Descrizione
Proprietà pubblica ButtonCount Ottiene o imposta il numero di pulsanti da visualizzare in un oggetto NumericPagerField.
Proprietà pubblica ButtonType Ottiene o imposta il tipo di pulsante da visualizzare nel campo del pager.
Proprietà pubblica CurrentPageLabelCssClass Ottiene o imposta la classe del foglio di stile CSS utilizzata per definire lo stile del numero di pagina corrente.
Proprietà protetta. DataPager Ottiene un riferimento al pager di dati a cui l'oggetto DataPagerField è associato. (Ereditato da DataPagerField)
Proprietà protetta. IsTrackingViewState Ottiene un valore che indica se l'oggetto DataPagerField tiene traccia delle modifiche apportate al relativo stato di visualizzazione. (Ereditato da DataPagerField)
Proprietà pubblica NextPageImageUrl Ottiene o imposta l'URL di un'immagine visualizzata per il pulsante Pagina successiva nell'oggetto NumericPagerField.
Proprietà pubblica NextPageText Ottiene o imposta il testo visualizzato per il pulsante relativo alla pagina successiva.
Proprietà pubblica 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.
Proprietà pubblica 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.
Proprietà pubblica PreviousPageImageUrl Ottiene o imposta l'URL di un'immagine visualizzata per il pulsante Pagina precedente nell'oggetto NumericPagerField.
Proprietà pubblica PreviousPageText Ottiene o imposta il testo visualizzato per il pulsante relativo alla pagina precedente.
Proprietà protetta. QueryStringHandled Ottiene o imposta un valore che indica se il campo della stringa di query è stato valutato. (Ereditato da DataPagerField)
Proprietà protetta. QueryStringValue Ottiene il valore del campo della stringa di query dall'URL della richiesta. (Ereditato da DataPagerField)
Proprietà pubblica RenderNonBreakingSpacesBetweenControls Ottiene o imposta un valore che indica se gli spazi unificatori verranno sottoposti a rendering tra i controlli.
Proprietà protetta. 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)
Proprietà pubblica Visible Ottiene o imposta un valore che indica se viene eseguito il rendering di un campo del pager di dati. (Ereditato da DataPagerField)
In alto
Metodi
  Nome Descrizione
Metodo protetto CloneField Infrastruttura. Crea una copia dell'oggetto corrente derivato da DataPagerField. (Ereditato da DataPagerField)
Metodo protetto CopyProperties Copia le proprietà dell'oggetto NumericPagerField corrente nell'oggetto DataPagerField specificato. (Esegue l'override di DataPagerField.CopyProperties(DataPagerField)).
Metodo pubblico CreateDataPagers Crea i controlli dell'interfaccia utente per l'oggetto campo del pager e li aggiunge al contenitore specificato. (Esegue l'override di DataPagerField.CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)).
Metodo protetto CreateField Crea e restituisce una nuova istanza della classe NumericPagerField. (Esegue l'override di DataPagerField.CreateField()).
Metodo pubblico Equals Determina se l'oggetto specificato è uguale all'oggetto NumericPagerField corrente. (Esegue l'override di Object.Equals(Object)).
Metodo protetto Finalize Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulitura prima che l'oggetto stesso venga recuperato dalla procedura di Garbage Collection. (Ereditato da Object)
Metodo pubblico GetHashCode Viene utilizzato come funzione hash per la classe NumericPagerField. (Esegue l'override di Object.GetHashCode()).
Metodo protetto GetQueryStringNavigateUrl Crea un URL che contiene un campo della stringa di query con il numero di pagina specificato. (Ereditato da DataPagerField)
Metodo pubblico GetType Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Metodo pubblico HandleEvent Gestisce gli eventi che si verificano nell'oggetto NumericPagerField ed esegue l'azione appropriata. (Esegue l'override di DataPagerField.HandleEvent(CommandEventArgs)).
Metodo protetto LoadViewState Ripristina informazioni sullo stato di visualizzazione salvate in precedenza. (Ereditato da DataPagerField)
Metodo protetto MemberwiseClone Consente di creare una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
Metodo protetto OnFieldChanged Genera l'evento FieldChanged. (Ereditato da DataPagerField)
Metodo protetto SaveViewState Salva le modifiche apportate allo stato di visualizzazione dell'oggetto DataPagerField. (Ereditato da DataPagerField)
Metodo pubblico ToString Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Metodo protetto 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)
In alto
Implementazioni esplicite dell'interfaccia
  Nome Descrizione
Implementazione esplicita dell'interfaccia Proprietà privata IStateManager.IsTrackingViewState Infrastruttura. Ottiene un valore che indica se l'oggetto DataPagerField tiene traccia delle modifiche apportate al relativo stato di visualizzazione. (Ereditato da DataPagerField)
Implementazione esplicita dell'interfaccia Metodo privato IStateManager.LoadViewState Infrastruttura. Ripristina informazioni sullo stato di visualizzazione salvate in precedenza. (Ereditato da DataPagerField)
Implementazione esplicita dell'interfaccia Metodo privato IStateManager.SaveViewState Infrastruttura. Salva le modifiche apportate allo stato di visualizzazione dell'oggetto DataPagerField. (Ereditato da DataPagerField)
Implementazione esplicita dell'interfaccia Metodo privato IStateManager.TrackViewState Infrastruttura. 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)
In alto
Note

La classe NumericPagerField visualizza i controlli di spostamento in un controllo DataPager. I controlli possono essere utilizzati per spostarsi tra i dati visualizzati da un controllo che implementa l'interfaccia IPageableItemContainer, ad esempio il controllo ListView. L'oggetto NumericPagerField visualizza i numeri di pagina come pulsanti su cui gli utenti possono fare clic per passare a una pagina specifica. Il controllo visualizza inoltre 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 utilizzando le proprietà elencate nella tabella riportata di seguito.

Property

Oggetto di 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 proprietà ButtonType per selezionare il tipo di pulsante visualizzato. Nella tabella riportata di seguito vengono elencati tipi di pulsante disponibili.

ButtonType

Oggetto di descrizione

ButtonType.Button

Controllo Button.

ButtonType.Image

Controllo ImageButton.

ButtonType.Link

Controllo LinkButton.

I controlli dell'oggetto NumericButtonCssClass sono sottoposti a rendering con spazi unificatori al loro interno. Se si desidera personalizzare questo comportamento, è possibile utilizzare la proprietà RenderNonBreakingSpacesBetweenControls.

È possibile nascondere un oggetto NumericPagerField in un controllo DataPager impostando la proprietà Visible su false. Non è possibile controllare la visibilità dei pulsanti Pagina successiva e Pagina precedente. Essi sono visualizzati dal controllo se nel controllo dati associato sono disponibili pagine aggiuntive da visualizzare. È possibile utilizzare la proprietà ButtonCount per specificare il numero di pulsanti visualizzati in un oggetto NumericPagerField. Ogni pulsante corrisponde a un numero di pagina.

È possibile impostare il testo del pulsante Pagina successiva impostando la proprietà NextPageText. È possibile impostare il testo del pulsante Pagina precedente impostando la proprietà PreviousPageText.

Quando la proprietà ButtonType è impostata su ButtonType.Image, è necessario indicare l'URL di un'immagine visualizzata per i pulsanti Pagina successiva e Pagina precedente. A tale scopo, impostare le proprietà NextPageImageUrl e PreviousPageImageUrl. In questo caso, la proprietà di testo corrispondente viene utilizzata come testo alternativo per l'immagine. Il testo specificato dalla proprietà NextPageImageUrl, ad esempio, viene visualizzato come testo alternativo per il pulsante immagine Pagina successiva. Nei browser che supportano le descrizioni comandi, questo testo viene visualizzato anche come descrizione comandi per il pulsante corrispondente.

Esempi

Nell'esempio riportato di seguito viene illustrato come utilizzare un oggetto NumericPagerField per spostarsi tra i dati visualizzati in un controllo ListView.

Visual Basic

<%@ 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="&lt; Prev"
              NextPageText="Next &gt;"
              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>
C#

<%@ 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="&lt; Prev"
              NextPageText="Next &gt;"
              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>
Informazioni sulla versione

.NET Framework

Supportato in: 4, 3.5
Piattaforme

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Codice thread safe
Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.
Vedere anche

Riferimenti

Spazio dei nomi System.Web.UI.WebControls
DataPager
DataPagerField
IPageableItemContainer
ListView
NextPreviousPagerField
TemplatePagerField

Altre risorse

Cenni preliminari sul controllo server Web ListView
Walkthrough: Displaying, Paging, and Sorting Data Using the ListView Web Server Control