NumericPagerField Classe

Definizione

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à
NumericPagerField

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

Vedi anche