Condividi tramite


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.

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

Esempio

Nell'esempio seguente viene illustrato come usare un NextPreviousPagerField 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>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 spostamento in un DataPager controllo. Questi controlli di spostamento possono essere usati per la pagina tramite i dati visualizzati da un controllo che implementa l'interfaccia IPageableItemContainer , ad esempio il ListView controllo.

La NextPreviousPagerField classe fornisce pulsanti che consentono agli utenti di spostarsi tra le pagine di dati una pagina alla volta o di passare alla prima o all'ultima pagina dei dati.

È possibile personalizzare l'aspetto dell'oggetto NextPreviousPagerField usando la ButtonCssClass proprietà per impostare lo stile dei pulsanti. È anche possibile usare la ButtonType proprietà per scegliere il tipo di pulsante visualizzato. Nella tabella seguente sono elencati i tipi di pulsante disponibili.

Tipo Descrizione
Button Controllo Button.
Image Controllo ImageButton.
Link Controllo LinkButton.

È possibile nascondere un oggetto in un DataPagerNextPreviousPagerField controllo impostando la Visible proprietà su false. È anche possibile nascondere i singoli pulsanti (la prima pagina, la pagina precedente, la pagina successiva e i pulsanti dell'ultima pagina) impostando le ShowFirstPageButtonproprietà , ShowNextPageButtonShowPreviousPageButton, e ShowLastPageButton su false.

Il NextPreviousPagerField controllo consente di specificare testo personalizzato per ogni pulsante usando le FirstPageTextproprietà , , NextPageTextPreviousPageTexte LastPageText .

Quando la ButtonType proprietà è impostata su ButtonType.Image, è necessario specificare l'URL di un'immagine che verrà visualizzata per il pulsante. È possibile impostare le immagini singolarmente per ogni pulsante impostando le FirstPageImageUrlproprietà , , PreviousPageImageUrlNextPageImageUrle LastPageImageUrl .

Quando la proprietà è impostata su ButtonType.Image, la ButtonType proprietà di testo corrispondente funge da testo alternativo per l'immagine. Ad esempio, il testo specificato dalla FirstPageText proprietà viene visualizzato come testo alternativo per il pulsante dell'immagine di prima pagina. Nei browser che supportano le descrizioni comandi, questo testo viene visualizzato anche come descrizione comando.

Costruttori

NextPreviousPagerField()

Inizializza una nuova istanza della classe NextPreviousPagerField.

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.

ButtonType

Ottiene o imposta il tipo di pulsante da visualizzare nel campo del pager.

DataPager

Ottiene un riferimento al pager di dati a cui l'oggetto DataPagerField è associato.

(Ereditato da DataPagerField)
FirstPageImageUrl

Ottiene o imposta l'URL di un'immagine visualizzata per il pulsante relativo alla prima pagina.

FirstPageText

Ottiene o imposta il testo visualizzato per il pulsante relativo alla prima pagina.

IsTrackingViewState

Ottiene un valore che indica se l'oggetto DataPagerField tiene traccia delle modifiche apportate al relativo stato di visualizzazione.

(Ereditato da DataPagerField)
LastPageImageUrl

Ottiene o imposta l'URL di un'immagine visualizzata per il pulsante relativo all'ultima pagina nell'oggetto NextPreviousPagerField.

LastPageText

Ottiene o imposta il testo visualizzato per il pulsante relativo all'ultima pagina.

NextPageImageUrl

Ottiene o imposta l'URL di un'immagine visualizzata per il pulsante relativo alla pagina successiva nell'oggetto NextPreviousPagerField.

NextPageText

Ottiene o imposta il testo visualizzato per il pulsante relativo alla pagina successiva.

PreviousPageImageUrl

Ottiene o imposta l'URL di un'immagine visualizzata per il pulsante relativo alla pagina precedente nell'oggetto NextPreviousPagerField.

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

Ottiene o imposta un valore che indica se i pulsanti disabilitati sono sottoposti a rendering come controlli Label dall'oggetto NextPreviousPagerField.

RenderNonBreakingSpacesBetweenControls

Ottiene o imposta un valore che indica se gli spazi unificatori sono sottoposti a rendering tra i controlli.

ShowFirstPageButton

Ottiene o imposta un valore che indica se il pulsante relativo alla prima pagina viene visualizzato in un oggetto NextPreviousPagerField.

ShowLastPageButton

Ottiene o imposta un valore che indica se il pulsante relativo all'ultima pagina viene visualizzato in un oggetto NextPreviousPagerField.

ShowNextPageButton

Ottiene o imposta un valore che indica se il pulsante relativo alla pagina successiva viene visualizzato in un oggetto NextPreviousPagerField.

ShowPreviousPageButton

Ottiene o imposta un valore che indica se il pulsante relativo alla pagina precedente viene visualizzato in un oggetto NextPreviousPagerField.

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

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto NextPreviousPagerField corrente.

GetHashCode()

Viene utilizzato come funzione hash per la classe NextPreviousPagerField.

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 nel controllo NextPreviousPagerField 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