NumericPagerField Class

Definition

Rappresenta un campo DataPager che consente agli utenti di selezionare un numero di pagina per pagina.Represents a DataPager field that enables users to select a page by page number.

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

Examples

Nell'esempio seguente viene illustrato come utilizzare un oggetto NumericPagerField per eseguire il paging dei dati visualizzati in un controllo ListView.The following example shows how to use a NumericPagerField object to page through data that is displayed in a ListView control.

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

Remarks

La classe NumericPagerField Visualizza i controlli di navigazione in un controllo DataPager.The NumericPagerField class displays navigation controls in a DataPager control. I controlli possono essere utilizzati per scorrere i dati visualizzati da un controllo che implementa l'interfaccia IPageableItemContainer, ad esempio il controllo ListView.The controls can be used to page through data that is displayed by a control that implements the IPageableItemContainer interface, such as the ListView control. L'oggetto NumericPagerField Visualizza i numeri di pagina come pulsanti su cui gli utenti possono fare clic per passare a una pagina specifica.The NumericPagerField object displays page numbers as buttons that users can click to move to specific a page. 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.The control also displays next-page and previous-page buttons that enable users to access more pages of data than the ones that are displayed by the control.

È possibile personalizzare l'aspetto dell'oggetto NumericPagerField usando le proprietà elencate nella tabella seguente.You can customize the appearance of the NumericPagerField object by using the properties that are listed in the following table.

ProprietàProperty DescrizioneDescription
CurrentPageLabelCssClass Classe CSS per il numero di pagina corrente.The CSS class for the current page number.
NextPreviousButtonCssClass Classe CSS per i pulsanti pagina successiva e pagina precedente.The CSS class for the next-page and previous-page buttons.
NumericButtonCssClass Classe CSS per i pulsanti che rappresentano i numeri di pagina.The CSS class for the buttons that represent the page numbers.

È possibile utilizzare la proprietà ButtonType per selezionare il tipo di pulsante che verrà visualizzato.You can use the ButtonType property to select the type of button that will be displayed. Nella tabella seguente sono elencati i tipi di pulsanti disponibili.The following table lists the available button types.

TipoButton type DescrizioneDescription
ButtonType.Button Controllo Button.A Button control.
ButtonType.Image Controllo ImageButton.An ImageButton control.
ButtonType.Link Controllo LinkButton.A LinkButton control.

I controlli all'interno dell'oggetto NumericButtonCssClass vengono sottoposti a rendering con spazi non di suddivisione tra di essi.The controls inside the NumericButtonCssClass object are rendered with non-breaking spaces between them. Se si desidera personalizzare questo comportamento, è possibile utilizzare la proprietà RenderNonBreakingSpacesBetweenControls.If you want to customize this behavior, you can use the RenderNonBreakingSpacesBetweenControls property.

È possibile nascondere un oggetto NumericPagerField in un controllo DataPager impostando la proprietà Visible su false.You can hide a NumericPagerField object in a DataPager control by setting the Visible property to false. Non è possibile controllare la visibilità dei pulsanti pagina successiva e pagina precedente.You cannot control the visibility of the next-page and previous-page buttons. Vengono visualizzati dal controllo se il controllo dati associato dispone di altre pagine disponibili per la visualizzazione.They are displayed by the control if the associated data control has additional pages available to display. È possibile utilizzare la proprietà ButtonCount per specificare il numero di pulsanti visualizzati in un oggetto NumericPagerField.You can use the ButtonCount property to specify how many buttons are displayed in a NumericPagerField object. Ogni pulsante corrisponde a un numero di pagina.Each button corresponds to a page number.

È possibile impostare il testo del pulsante pagina successiva impostando la proprietà NextPageText.You can set the text of the next-page button by setting the NextPageText property. È possibile impostare il testo del pulsante della pagina precedente utilizzando la proprietà PreviousPageText.You can set the text of the previous-page button by using the PreviousPageText property.

Quando la proprietà ButtonType è impostata su ButtonType.Image, è necessario fornire l'URL di un'immagine che verrà visualizzata per i pulsanti pagina successiva e pagina precedente.When the ButtonType property is set to ButtonType.Image, you must provide the URL of an image that will be displayed for the next-page and previous page buttons. A tale scopo, impostare le proprietà NextPageImageUrl e PreviousPageImageUrl.You do this by setting the NextPageImageUrl and PreviousPageImageUrl properties. In tal caso, la proprietà Text corrispondente viene utilizzata come testo alternativo per l'immagine.In that case, the corresponding text property is used as the alternate text for the image. Il testo specificato dalla proprietà NextPageImageUrl, ad esempio, viene visualizzato come testo alternativo per il pulsante immagine pagina successiva.For example, the text that is specified by the NextPageImageUrl property is displayed as the alternate text for the next-page image button. Nei browser che supportano le descrizioni comandi, questo testo viene visualizzato anche come descrizione comando per il pulsante corrispondente.On browsers that support tooltips, this text is also displayed as a tooltip for the corresponding button.

Constructors

NumericPagerField()

Inizializza una nuova istanza della classe NumericPagerField.Initializes a new instance of the NumericPagerField class.

Properties

ButtonCount

Ottiene o imposta il numero di pulsanti da visualizzare in un oggetto NumericPagerField.Gets or sets the number of buttons to display in a NumericPagerField object.

ButtonType

Ottiene o imposta il tipo di pulsante da visualizzare nel campo del pager.Gets or sets the button type to display in the pager field.

CurrentPageLabelCssClass

Ottiene o imposta la classe del foglio di stile CSS utilizzata per definire lo stile del numero di pagina corrente.Gets or sets the cascading style sheet (CSS) class that is used to style the current page number.

DataPager

Ottiene un riferimento al pager di dati a cui l'oggetto DataPagerField è associato.Gets a reference to the data pager that the DataPagerField object is associated with.

(Inherited from DataPagerField)
IsTrackingViewState

Ottiene un valore che indica se l'oggetto DataPagerField tiene traccia delle modifiche apportate al relativo stato di visualizzazione.Gets a value that indicates whether the DataPagerField object is tracking its view-state changes.

(Inherited from DataPagerField)
NextPageImageUrl

Ottiene o imposta l'URL di un'immagine visualizzata per il pulsante Pagina successiva nell'oggetto NumericPagerField.Gets or sets the URL of an image that is displayed for the next-page button in the NumericPagerField object.

NextPageText

Ottiene o imposta il testo visualizzato per il pulsante relativo alla pagina successiva.Gets or sets the text that is displayed for the next-page button.

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.Gets or sets the cascading style sheet (CSS) class that is used to style the next-page and previous-page buttons of the pager field.

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.Gets or sets the cascading style sheet (CSS) class that is used to style the page-number buttons of the pager field.

PreviousPageImageUrl

Ottiene o imposta l'URL di un'immagine visualizzata per il pulsante Pagina precedente nell'oggetto NumericPagerField.Gets or sets the URL of an image that is displayed for the previous-page button in the NumericPagerField object.

PreviousPageText

Ottiene o imposta il testo visualizzato per il pulsante relativo alla pagina precedente.Gets or sets the text that is displayed for the previous-page button.

QueryStringHandled

Ottiene o imposta un valore che indica se il campo della stringa di query è stato valutato.Gets or sets a value that indicates whether the query string field has been evaluated.

(Inherited from DataPagerField)
QueryStringValue

Ottiene il valore del campo della stringa di query dall'URL della richiesta.Gets the value of the query string field from the URL of the request.

(Inherited from DataPagerField)
RenderNonBreakingSpacesBetweenControls

Ottiene o imposta un valore che indica se gli spazi unificatori verranno sottoposti a rendering tra i controlli.Gets or sets a value that indicates whether non-breaking spaces will be rendered between controls.

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.Gets a dictionary of state information that enables you to save and restore the view state of a DataPagerField object across multiple requests for the same page.

(Inherited from DataPagerField)
Visible

Ottiene o imposta un valore che indica se viene eseguito il rendering di un campo del pager di dati.Gets or sets a value that indicates whether a data pager field is rendered.

(Inherited from DataPagerField)

Methods

CloneField()

Crea una copia dell'oggetto corrente derivato da DataPagerField.Creates a copy of the current object that is derived from DataPagerField.

(Inherited from DataPagerField)
CopyProperties(DataPagerField)

Copia le proprietà dell'oggetto NumericPagerField corrente nell'oggetto DataPagerField specificato.Copies the properties of the current NumericPagerField object to the specified DataPagerField object.

CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)

Crea i controlli dell'interfaccia utente per l'oggetto campo del pager e li aggiunge al contenitore specificato.Creates the user interface (UI) controls for the pager field object and adds them to the specified container.

CreateField()

Crea e restituisce una nuova istanza della classe NumericPagerField.Creates and returns a new instance of the NumericPagerField class.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto NumericPagerField corrente.Determines whether the specified object is equal to the current NumericPagerField object.

GetHashCode()

Viene utilizzato come funzione hash per la classe NumericPagerField.Serves as a hash function for the NumericPagerField class.

GetQueryStringNavigateUrl(Int32)

Crea un URL che contiene un campo della stringa di query con il numero di pagina specificato.Creates a URL that contains a query string field that has the specified page number.

(Inherited from DataPagerField)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
HandleEvent(CommandEventArgs)

Gestisce gli eventi che si verificano nell'oggetto NumericPagerField ed esegue l'azione appropriata.Handles events that occur in the NumericPagerField object and performs the appropriate action.

LoadViewState(Object)

Ripristina informazioni sullo stato di visualizzazione salvate in precedenza.Restores view-state information that was saved previously.

(Inherited from DataPagerField)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
OnFieldChanged()

Genera l'evento FieldChanged.Raises the FieldChanged event.

(Inherited from DataPagerField)
SaveViewState()

Salva le modifiche apportate allo stato di visualizzazione dell'oggetto DataPagerField.Saves the changes that were made to the DataPagerField object's view state.

(Inherited from DataPagerField)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from 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.Causes the DataPagerField object to track changes to its view state so that they can be stored in the control's ViewState property and persisted across requests for the same page.

(Inherited from DataPagerField)

Explicit Interface Implementations

IStateManager.IsTrackingViewState

Ottiene un valore che indica se l'oggetto DataPagerField tiene traccia delle modifiche apportate al relativo stato di visualizzazione.Gets a value that indicates whether the DataPagerField object is tracking its view-state changes.

(Inherited from DataPagerField)
IStateManager.LoadViewState(Object)

Ripristina informazioni sullo stato di visualizzazione salvate in precedenza.Restores view-state information that was saved previously.

(Inherited from DataPagerField)
IStateManager.SaveViewState()

Salva le modifiche apportate allo stato di visualizzazione dell'oggetto DataPagerField.Saves the changes that were made to the DataPagerField object's view state.

(Inherited from 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.Causes the DataPagerField object to track changes to its view state so that they can be stored in the control's ViewState property and persisted across requests for the same page.

(Inherited from DataPagerField)

Applies to

See also