NumericPagerField NumericPagerField NumericPagerField NumericPagerField Class

Definizione

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
Ereditarietà
NumericPagerFieldNumericPagerFieldNumericPagerFieldNumericPagerField

Esempi

Nell'esempio seguente viene illustrato come utilizzare un NumericPagerField oggetto per scorrere i dati visualizzati in un ListView controllo.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>

Commenti

La NumericPagerField classe Visualizza i controlli di spostamento DataPager in un controllo.The NumericPagerField class displays navigation controls in a DataPager control. I controlli possono essere utilizzati per eseguire il paging dei dati visualizzati da un controllo che implementa l' IPageableItemContainer interfaccia, ad esempio il ListView controllo.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' NumericPagerField oggetto 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' NumericPagerField oggetto utilizzando 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 DescriptionDescription
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 usare la ButtonType proprietà 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 DescriptionDescription
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 NumericButtonCssClass dell'oggetto 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 RenderNonBreakingSpacesBetweenControls proprietà.If you want to customize this behavior, you can use the RenderNonBreakingSpacesBetweenControls property.

È possibile nascondere un NumericPagerField oggetto in un DataPager controllo impostando la Visible proprietà 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 ButtonCount proprietà per specificare il numero di pulsanti visualizzati in un NumericPagerField oggetto.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 NextPageText proprietà.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 PreviousPageText proprietà.You can set the text of the previous-page button by using the PreviousPageText property.

Quando la ButtonType proprietà è 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 NextPageImageUrl proprietà PreviousPageImageUrl e.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 NextPageImageUrl proprietà, ad esempio, viene visualizzato come testo alternativo per il pulsante di immagine della 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.

Costruttori

NumericPagerField() NumericPagerField() NumericPagerField() NumericPagerField()

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

Proprietà

ButtonCount ButtonCount ButtonCount 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 ButtonType ButtonType 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 CurrentPageLabelCssClass CurrentPageLabelCssClass 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 DataPager DataPager 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)
IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState 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)
IsTrackingViewState IsTrackingViewState IsTrackingViewState 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 NextPageImageUrl NextPageImageUrl 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 NextPageText NextPageText 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 NextPreviousButtonCssClass NextPreviousButtonCssClass 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 NumericButtonCssClass NumericButtonCssClass 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 PreviousPageImageUrl PreviousPageImageUrl 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 PreviousPageText PreviousPageText 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 QueryStringHandled QueryStringHandled 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 QueryStringValue QueryStringValue 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 RenderNonBreakingSpacesBetweenControls RenderNonBreakingSpacesBetweenControls 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 ViewState ViewState 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 Visible Visible 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)

Metodi

CloneField() CloneField() CloneField() 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) CopyProperties(DataPagerField) CopyProperties(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) CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32) CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32) 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() CreateField() CreateField() CreateField()

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

Equals(Object) Equals(Object) Equals(Object) 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() GetHashCode() GetHashCode() GetHashCode()

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

GetQueryStringNavigateUrl(Int32) GetQueryStringNavigateUrl(Int32) GetQueryStringNavigateUrl(Int32) 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() GetType() GetType() GetType()

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

(Inherited from Object)
HandleEvent(CommandEventArgs) HandleEvent(CommandEventArgs) HandleEvent(CommandEventArgs) 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) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

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

(Inherited from DataPagerField)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnFieldChanged() OnFieldChanged() OnFieldChanged() OnFieldChanged()

Genera l'evento FieldChanged.Raises the FieldChanged event.

(Inherited from DataPagerField)
SaveViewState() SaveViewState() SaveViewState() 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() ToString() ToString() ToString()

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

(Inherited from Object)
TrackViewState() TrackViewState() TrackViewState() 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)

Implementazioni dell'interfaccia esplicita

IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) 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() IStateManager.SaveViewState() IStateManager.SaveViewState() 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() IStateManager.TrackViewState() IStateManager.TrackViewState() 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)

Si applica a

Vedi anche