Condividi tramite


PagerSettings Classe

Definizione

Rappresenta le proprietà dei controlli di paginazione in un controllo che supporta la paginazione. La classe non può essere ereditata.

public ref class PagerSettings sealed : System::Web::UI::IStateManager
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))]
public sealed class PagerSettings : System.Web.UI.IStateManager
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))>]
type PagerSettings = class
    interface IStateManager
Public NotInheritable Class PagerSettings
Implements IStateManager
Ereditarietà
PagerSettings
Attributi
Implementazioni

Esempio

Nell'esempio di codice seguente viene illustrato come usare l'oggetto PagerSettings contenuto nella PagerSettings proprietà per personalizzare il testo dei pulsanti visualizzati nella riga del pager di un GridView 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 runat="server">
    <title>PagerSetting Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>PagerSetting Example</h3>
                       
        <asp:gridview id="CustomerGridView"
          datasourceid="CustomerDataSource"
          autogeneratecolumns="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          runat="server">
          
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"   
            position="Bottom"/> 
            
        </asp:gridview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the Web.config file.                            -->
        <asp:sqldatasource id="CustomerDataSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </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 runat="server">
    <title>PagerSetting Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>PagerSetting Example</h3>
                       
        <asp:gridview id="CustomerGridView"
          datasourceid="CustomerDataSource"
          autogeneratecolumns="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          runat="server">
          
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"   
            position="Bottom"/> 
            
        </asp:gridview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the Web.config file.                            -->
        <asp:sqldatasource id="CustomerDataSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </form>
  </body>
</html>

Commenti

I controlli che supportano la paginazione ,ad esempio GridView, DetailsViewe FormView controlli, possono visualizzare un set di controlli denominato pager che consente all'utente di spostarsi nelle pagine all'interno del controllo. La PagerSettings classe viene usata da questi controlli per rappresentare le proprietà del pager. In generale, l'oggetto PagerSettings viene archiviato nella PagerSettings proprietà del controllo. È possibile personalizzare il pager impostando le proprietà dell'oggetto PagerSettings .

Il pager supporta diverse modalità di visualizzazione. Per specificare la modalità in cui visualizzare il pager, impostare la Mode proprietà. Nella tabella seguente vengono descritte le diverse modalità.

Mode Descrizione
NextPrevious Pulsanti pagina precedente e pagina successiva.
NextPreviousFirstLast Pulsanti di pagina precedente, next-page, first-page e last-page.
Numeric Pulsanti di collegamento numerati per accedere direttamente alle pagine.
NumericFirstLast Pulsanti di collegamento numerati, first-link e last-link.

Quando la Mode proprietà è impostata sul NextPreviousvalore , NextPreviousFirstLasto NumericFirstLast è possibile personalizzare il testo dei pulsanti non numerici impostando le proprietà visualizzate nella tabella seguente.

Proprietà Descrizione
FirstPageText Testo per il pulsante della prima pagina.
PreviousPageText Testo per il pulsante della pagina precedente.
NextPageText Testo per il pulsante della pagina successiva.
LastPageText Testo per il pulsante dell'ultima pagina.

In alternativa, è anche possibile visualizzare immagini per i pulsanti non numerici impostando le proprietà, come illustrato nella tabella seguente.

Proprietà Descrizione
FirstPageImageUrl URL di un'immagine da visualizzare per il pulsante di collegamento alla prima pagina.
PreviousPageImageUrl URL di un'immagine da visualizzare per il pulsante di collegamento alla pagina precedente.
NextPageImageUrl URL di un'immagine da visualizzare per il pulsante di collegamento alla pagina successiva.
LastPageImageUrl URL di un'immagine da visualizzare per il pulsante di collegamento all'ultima pagina.

Nota

Quando viene impostata una proprietà image, la proprietà di testo corrispondente funge da testo alternativo per l'immagine. Ad esempio, quando la FirstPageImageUrl proprietà è impostata, il testo specificato dalla FirstPageText proprietà viene visualizzato come testo alternativo per l'immagine. Nei browser che supportano le descrizioni comandi, questo testo viene visualizzato anche come descrizione comando per il pulsante corrispondente.

Quando la Mode proprietà è impostata sul Numeric valore o NumericFirstLast , è possibile specificare il numero di pulsanti di pagina da visualizzare nel pager impostando la PageButtonCount proprietà.

Il pager può essere visualizzato nella parte superiore, nella parte inferiore o nella parte superiore e inferiore di un controllo. Per specificare la posizione del pager, impostare la Position proprietà . Per visualizzare o nascondere il pager, usare la Visible proprietà .

Costruttori

PagerSettings()

Inizializza una nuova istanza della classe PagerSettings.

Proprietà

FirstPageImageUrl

Ottiene o imposta l'URL di un'immagine da visualizzare per il pulsante di collegamento alla prima pagina.

FirstPageText

Ottiene o imposta il testo da visualizzare per il pulsante di collegamento alla prima pagina.

LastPageImageUrl

Ottiene o imposta l'URL di un'immagine da visualizzare per il pulsante di collegamento all'ultima pagina.

LastPageText

Ottiene o imposta il testo da visualizzare per il pulsante di collegamento all'ultima pagina.

Mode

Ottiene o imposta il modo in cui visualizzare i controlli del pager in un controllo che supporta la paginazione.

NextPageImageUrl

Ottiene o imposta l'URL di un'immagine da visualizzare per il pulsante di collegamento pagina successiva.

NextPageText

Ottiene o imposta il testo da visualizzare per il pulsante di collegamento alla pagina successiva.

PageButtonCount

Ottiene o imposta il numero di pagine da visualizzare nel pager quando la proprietà Mode è impostata sul valore Numeric oppure NumericFirstLast.

Position

Ottiene o imposta un valore che specifica il posizione in cui viene visualizzato il pager.

PreviousPageImageUrl

Ottiene o imposta l'URL di un'immagine da visualizzare per il pulsante di collegamento alla pagina precedente.

PreviousPageText

Ottiene o imposta il testo da visualizzare per il pulsante di collegamento alla pagina precedente.

Visible

Ottiene o imposta un valore che indica se i controlli per il paging sono visualizzati in un controllo che supporta la paginazione.

Metodi

Equals(Object)

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

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ToString()

Consente di recuperare la rappresentazione in forma di stringa di un oggetto PagerSettings.

Eventi

PropertyChanged

Viene generato quando vengono modificati i valori di una proprietà di un oggetto PagerSettings.

Implementazioni dell'interfaccia esplicita

IStateManager.IsTrackingViewState

Ottiene un valore che indica se il controllo server tiene traccia delle modifiche allo stato di visualizzazione.

IStateManager.LoadViewState(Object)

Consente di caricare lo stato di visualizzazione dell'oggetto PagerSettings precedentemente salvato.

IStateManager.SaveViewState()

Salva lo stato di visualizzazione corrente dell'oggetto PagerSettings.

IStateManager.TrackViewState()

Viene contrassegnato il punto iniziale per la registrazione e il salvataggio delle modifiche dello stato di visualizzazione nell'oggetto PagerSettings.

Si applica a

Vedi anche