NextPreviousPagerField Classe

Definizione

Rappresenta un campo che visualizza i controlli per la navigazione in un controllo DataPager che consentono agli utenti di spostarsi tra i dati.Represents a field that displays navigation controls in a DataPager control enable users to page through data.

public ref class NextPreviousPagerField : System::Web::UI::WebControls::DataPagerField
public class NextPreviousPagerField : System.Web.UI.WebControls.DataPagerField
type NextPreviousPagerField = class
    inherit DataPagerField
Public Class NextPreviousPagerField
Inherits DataPagerField
Ereditarietà
NextPreviousPagerField

Esempi

Nell'esempio seguente viene illustrato come utilizzare un NextPreviousPagerField oggetto per scorrere i dati visualizzati in un ListView controllo.The following example shows how to use a NextPreviousPagerField 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>NextPreviousPagerField Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NextPreviousPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="ContactIDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td>
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <asp:DataPager runat="server" ID="ContactsDataPager" PagedControlID="ContactsListView">
        <Fields>
          <asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true" />
        </Fields>
      </asp:DataPager>

      <!-- 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>NextPreviousPagerField Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NextPreviousPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="ContactIDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td>
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <asp:DataPager runat="server" ID="ContactsDataPager" PagedControlID="ContactsListView">
        <Fields>
          <asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true" />
        </Fields>
      </asp:DataPager>

      <!-- 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 NextPreviousPagerField classe rappresenta un campo che Visualizza i controlli di navigazione DataPager in un controllo.The NextPreviousPagerField class represents a field that displays navigation controls in a DataPager control. Questi controlli di navigazione possono essere utilizzati per eseguire il paging dei dati visualizzati da un controllo che implementa IPageableItemContainer l'interfaccia, ad esempio ListView il controllo.These navigation controls can be used to page through data that are displayed by a control that implements the IPageableItemContainer interface, such as the ListView control.

La NextPreviousPagerField classe fornisce pulsanti che consentono agli utenti di spostarsi tra le pagine dei dati una pagina alla volta o di passare alla prima o all'ultima pagina di dati.The NextPreviousPagerField class provides buttons that enable users to navigate through the pages of data one page at a time, or to jump to the first or last page of data.

È possibile personalizzare l'aspetto dell' NextPreviousPagerField oggetto utilizzando la ButtonCssClass proprietà per impostare lo stile dei pulsanti.You can customize the appearance of the NextPreviousPagerField object by using the ButtonCssClass property to set the style of the buttons. È anche possibile usare la ButtonType proprietà per scegliere il tipo di pulsante visualizzato.You can also use the ButtonType property to choose the type of button that is displayed. Nella tabella seguente sono elencati i tipi di pulsanti disponibili.The following table lists the available button types.

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

È possibile nascondere un NextPreviousPagerField oggetto in un DataPager controllo impostando la Visible proprietà su false.You can hide a NextPreviousPagerField object in a DataPager control by setting the Visible property to false. È anche possibile nascondere i singoli pulsanti (i pulsanti di prima pagina, pagina precedente, pagina successiva e ultima pagina ShowFirstPageButton) impostando le proprietà ShowNextPageButton, ShowPreviousPageButton, e ShowLastPageButton su false.You can also hide the individual buttons (the first-page, previous-page, next-page, and last-page buttons) by setting the ShowFirstPageButton, ShowPreviousPageButton, ShowNextPageButton, and ShowLastPageButton properties to false.

Il NextPreviousPagerField controllo consente di specificare il testo personalizzato per ogni pulsante usando le FirstPageTextproprietà, PreviousPageText NextPageText, e LastPageText .The NextPreviousPagerField control enables you to specify custom text for each button by using the FirstPageText, PreviousPageText, NextPageText, and LastPageText properties.

Quando la ButtonType proprietà è impostata su ButtonType.Image, è necessario fornire l'URL di un'immagine che verrà visualizzata per il pulsante.When the ButtonType property is set to ButtonType.Image, you must provide the URL to an image that will be displayed for the button. È possibile impostare le immagini singolarmente per ogni pulsante impostando PreviousPageImageUrlle NextPageImageUrl FirstPageImageUrlproprietà, LastPageImageUrl , e.You can set images individually for each button by setting the FirstPageImageUrl, PreviousPageImageUrl, NextPageImageUrl, and LastPageImageUrl properties.

Quando la ButtonType proprietà è impostata su ButtonType.Image, la proprietà Text corrispondente funge da testo alternativo per l'immagine.When the ButtonType property is set to ButtonType.Image, the corresponding text property acts as the alternate text for the image. Il testo specificato dalla FirstPageText proprietà, ad esempio, viene visualizzato come testo alternativo per il pulsante di immagine della prima pagina.For example, the text that is specified by the FirstPageText property is displayed as the alternate text for the first-page image button. Nei browser che supportano le descrizioni comandi, questo testo viene visualizzato anche come descrizione comando.In browsers that support tooltips, this text is also displayed as a tooltip.

Costruttori

NextPreviousPagerField()

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

Proprietà

ButtonCssClass

Ottiene o imposta la classe del foglio di stile CSS utilizzata per eseguire il rendering dei pulsanti del campo del pager nel browser.Gets or sets the cascading style sheet (CSS) class that is used to render the buttons of the pager field on the browser.

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.

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.

(Ereditato da DataPagerField)
FirstPageImageUrl

Ottiene o imposta l'URL di un'immagine visualizzata per il pulsante relativo alla prima pagina.Gets or sets the URL to an image that is displayed for the first-page button.

FirstPageText

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

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.

(Ereditato da DataPagerField)
LastPageImageUrl

Ottiene o imposta l'URL di un'immagine visualizzata per il pulsante relativo all'ultima pagina nell'oggetto NextPreviousPagerField.Gets or sets the URL to an image that is displayed for the last-page button in the NextPreviousPagerField object.

LastPageText

Ottiene o imposta il testo visualizzato per il pulsante relativo all'ultima pagina.Gets or sets the text that is displayed for the last-page button.

NextPageImageUrl

Ottiene o imposta l'URL di un'immagine visualizzata per il pulsante relativo alla pagina successiva nell'oggetto NextPreviousPagerField.Gets or sets the URL to an image that is displayed for the next-page button in the NextPreviousPagerField 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.

PreviousPageImageUrl

Ottiene o imposta l'URL di un'immagine visualizzata per il pulsante relativo alla pagina precedente nell'oggetto NextPreviousPagerField.Gets or sets the URL to an image that is displayed for the previous-page button in the NextPreviousPagerField 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.

(Ereditato da 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.

(Ereditato da DataPagerField)
RenderDisabledButtonsAsLabels

Ottiene o imposta un valore che indica se i pulsanti disabilitati sono sottoposti a rendering come controlli Label dall'oggetto NextPreviousPagerField.Gets or sets a value that indicates whether disabled buttons are rendered as Label controls by the NextPreviousPagerField object.

RenderNonBreakingSpacesBetweenControls

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

ShowFirstPageButton

Ottiene o imposta un valore che indica se il pulsante relativo alla prima pagina viene visualizzato in un oggetto NextPreviousPagerField.Gets or sets a value that indicates whether the first-page button is displayed in a NextPreviousPagerField object.

ShowLastPageButton

Ottiene o imposta un valore che indica se il pulsante relativo all'ultima pagina viene visualizzato in un oggetto NextPreviousPagerField.Gets or sets a value that indicates whether the last-page button is displayed in a NextPreviousPagerField object.

ShowNextPageButton

Ottiene o imposta un valore che indica se il pulsante relativo alla pagina successiva viene visualizzato in un oggetto NextPreviousPagerField.Gets or sets a value that indicates whether the next-page button is displayed in a NextPreviousPagerField object.

ShowPreviousPageButton

Ottiene o imposta un valore che indica se il pulsante relativo alla pagina precedente viene visualizzato in un oggetto NextPreviousPagerField.Gets or sets a value that indicates whether the previous-page button is displayed in a NextPreviousPagerField object.

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.

(Ereditato da 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.

(Ereditato da DataPagerField)

Metodi

CloneField()

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

(Ereditato da DataPagerField)
CopyProperties(DataPagerField)

Copia le proprietà dell'oggetto NextPreviousPagerField corrente nell'oggetto DataPagerField specificato.Copies the properties of the current NextPreviousPagerField 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 NextPreviousPagerField.Creates and returns a new instance of the NextPreviousPagerField class.

Equals(Object)

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

GetHashCode()

Viene utilizzato come funzione hash per la classe NextPreviousPagerField.Serves as a hash function for the NextPreviousPagerField 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.

(Ereditato da DataPagerField)
GetType()

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

(Ereditato da Object)
HandleEvent(CommandEventArgs)

Gestisce gli eventi che si verificano nel controllo NextPreviousPagerField ed esegue l'azione appropriata.Handles events that occur in the NextPreviousPagerField control and performs the appropriate action.

LoadViewState(Object)

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

(Ereditato da DataPagerField)
MemberwiseClone()

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

(Ereditato da Object)
OnFieldChanged()

Genera l'evento FieldChanged.Raises the FieldChanged event.

(Ereditato da 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.

(Ereditato da DataPagerField)
ToString()

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

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

(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.Gets a value that indicates whether the DataPagerField object is tracking its view-state changes.

(Ereditato da DataPagerField)
IStateManager.LoadViewState(Object)

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

(Ereditato da 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.

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

(Ereditato da DataPagerField)

Si applica a

Vedi anche