PagerSettings Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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à: Object
PagerSettings

Attributi: TypeConverterAttribute

Implementazioni: IStateManager

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