NumericPagerField Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.Extensions.dll

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::DataPagerField

public class NumericPagerField : System.Web.UI.WebControls.DataPagerField

type NumericPagerField = class
    inherit DataPagerField

Public Class NumericPagerField
Inherits DataPagerField

Ereditarietà: Object

DataPagerField
NumericPagerField

Esempio

Nell'esempio seguente viene illustrato come usare un NumericPagerField oggetto per la pagina tramite 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 usati per la pagina tramite 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 spostarsi in una pagina specifica. Il controllo visualizza anche pulsanti di pagina successiva e pagina precedente che consentono agli utenti di accedere a più pagine di dati rispetto a quelli visualizzati 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 di pagina successiva e pagina precedente.
NumericButtonCssClass	Classe CSS per i pulsanti che rappresentano i numeri di pagina.

È possibile usare 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.

I controlli all'interno dell'oggetto NumericButtonCssClass vengono sottoposti a rendering con spazi non di interruzione tra di essi. Se si vuole personalizzare questo comportamento, è possibile usare la RenderNonBreakingSpacesBetweenControls proprietà .

È possibile nascondere un oggetto in un DataPager NumericPagerField controllo impostando la Visible proprietà su false. Non è possibile controllare la visibilità dei pulsanti della pagina successiva e della pagina precedente. Vengono visualizzati dal controllo se il controllo dati associato dispone di pagine aggiuntive disponibili per la visualizzazione. È possibile usare la proprietà per specificare il ButtonCount numero di pulsanti visualizzati in un NumericPagerField oggetto. Ogni pulsante corrisponde a un numero di pagina.

È possibile impostare il testo del pulsante di 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 di pagina successiva e pagina precedente. Questa operazione viene eseguita impostando le NextPageImageUrl proprietà e PreviousPageImageUrl . In tal caso, la proprietà di testo corrispondente viene usata 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 comandi, 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 `FieldChanged`. (Ereditato da DataPagerField)
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)

Si applica a