PagerSettings Classe

Definizione

Rappresenta le proprietà dei controlli di paginazione in un controllo che supporta la paginazione.Represents the properties of the paging controls in a control that supports pagination. Questa classe non può essere ereditata.This class cannot be inherited.

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

Esempi

Nell'esempio di codice seguente viene illustrato come utilizzare PagerSettings l'oggetto contenuto PagerSettings nella proprietà per personalizzare il testo dei pulsanti visualizzati nella riga di cercapersone di un GridView controllo.The following code example demonstrates how to use the PagerSettings object that is contained in the PagerSettings property to customize the text of the buttons that are displayed in the pager row of a GridView 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 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 l'impaginazione (ad GridViewesempio DetailsViewi controlli FormView , e) possono visualizzare un set di controlli denominato cercapersone che consente all'utente di spostarsi tra le pagine all'interno del controllo.Controls that support pagination (such as the GridView, DetailsView, and FormView controls) can display a set of controls called the pager that allows the user to navigate the pages within the control. La PagerSettings classe viene utilizzata da questi controlli per rappresentare le proprietà del cercapersone.The PagerSettings class is used by these controls to represent the properties of the pager. In generale, l' PagerSettings oggetto viene archiviato PagerSettings nella proprietà del controllo.In general, the PagerSettings object is stored in the PagerSettings property of the control. È possibile personalizzare il pager impostando le proprietà dell' PagerSettings oggetto.You can customize the pager by setting the properties of the PagerSettings object.

Il pager supporta diverse modalità di visualizzazione.The pager supports several different display modes. Per specificare la modalità in cui visualizzare il cercapersone, impostare la Mode proprietà.To specify the mode in which to display the pager, set the Mode property. Nella tabella seguente vengono descritte le diverse modalità.The following table describes the different modes.

ModalitàMode DescriptionDescription
NextPrevious Pulsanti della pagina precedente e della pagina successiva.Previous-page and next-page buttons.
NextPreviousFirstLast Pulsanti pagina precedente, pagina successiva, prima pagina e ultima pagina.Previous-page, next-page, first-page, and last -page buttons.
Numeric Pulsanti di collegamento numerati per accedere direttamente alle pagine.Numbered link buttons to access pages directly.
NumericFirstLast Pulsanti numerati, collegamento, primo collegamento e ultimo collegamento.Numbered-link, first-link, and last-link buttons.

Quando la Mode proprietà è impostata NextPrevioussul valore, NextPreviousFirstLasto NumericFirstLast è possibile personalizzare il testo dei pulsanti non numerici impostando le proprietà mostrate nella tabella seguente.When the Mode property is set to the NextPrevious, NextPreviousFirstLast, or NumericFirstLast value you can customize the text of the non-numeric buttons by setting the properties shown in the following table.

ProprietàProperty DescriptionDescription
FirstPageText Testo per il pulsante della prima pagina.Text for the first-page button.
PreviousPageText Testo per il pulsante della pagina precedente.Text for the previous-page button.
NextPageText Testo per il pulsante pagina successiva.Text for the next-page button.
LastPageText Testo per il pulsante relativo all'ultima pagina.Text for the last-page button.

In alternativa, è possibile visualizzare anche le immagini per i pulsanti non numerici impostando le proprietà come illustrato nella tabella seguente.As an alternative, you can also display images for the non-numeric buttons by setting the properties as shown in the following table.

ProprietàProperty DescriptionDescription
FirstPageImageUrl URL di un'immagine da visualizzare per il pulsante di collegamento alla prima pagina.The URL to an image to display for the first-page button.
PreviousPageImageUrl URL di un'immagine da visualizzare per il pulsante di collegamento alla pagina precedente.The URL to an image to display for the previous-page button.
NextPageImageUrl URL di un'immagine da visualizzare per il pulsante di collegamento alla pagina successiva.The URL to an image to display for the next-page button.
LastPageImageUrl URL di un'immagine da visualizzare per il pulsante di collegamento all'ultima pagina.The URL to an image to display for the last-page button.

Nota

Quando viene impostata una proprietà Image, la proprietà Text corrispondente funge da testo alternativo per l'immagine.When an image property is set, the corresponding text property acts as the alternate text for the image. Ad esempio, quando la FirstPageImageUrl proprietà è impostata, il testo specificato FirstPageText dalla proprietà viene visualizzato come testo alternativo per l'immagine.For example, when the FirstPageImageUrl property is set, the text that is specified by the FirstPageText property is displayed as the alternate text for the image. 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.

Quando la Mode proprietà è impostata Numeric sul valore o NumericFirstLast , è possibile specificare il numero di pulsanti di pagina da visualizzare nel cercapersone impostando la PageButtonCount proprietà.When the Mode property is set to the Numeric or NumericFirstLast value, you can specify the number of page buttons to display in the pager by setting the PageButtonCount property.

Il pager può essere visualizzato nella parte superiore, in basso o nella parte superiore e inferiore di un controllo.The pager can be displayed at the top, the bottom, or both the top and bottom of a control. Per specificare la posizione del cercapersone, impostare la Position proprietà.To specify the position of the pager, set the Position property. Per visualizzare o nascondere il pager, utilizzare la Visible proprietà.To show or hide the pager, use the Visible property.

Costruttori

PagerSettings()

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

Proprietà

FirstPageImageUrl

Ottiene o imposta l'URL di un'immagine da visualizzare per il pulsante di collegamento alla prima pagina.Gets or sets the URL to an image to display for the first-page button.

FirstPageText

Ottiene o imposta il testo da visualizzare per il pulsante di collegamento alla prima pagina.Gets or sets the text to display for the first-page button.

LastPageImageUrl

Ottiene o imposta l'URL di un'immagine da visualizzare per il pulsante di collegamento all'ultima pagina.Gets or sets the URL to an image to display for the last-page button.

LastPageText

Ottiene o imposta il testo da visualizzare per il pulsante di collegamento all'ultima pagina.Gets or sets the text to display for the last-page button.

Mode

Ottiene o imposta il modo in cui visualizzare i controlli del pager in un controllo che supporta la paginazione.Gets or sets the mode in which to display the pager controls in a control that supports pagination.

NextPageImageUrl

Ottiene o imposta l'URL di un'immagine da visualizzare per il pulsante di collegamento pagina successiva.Gets or sets the URL to an image to display for the next-page button.

NextPageText

Ottiene o imposta il testo da visualizzare per il pulsante di collegamento alla pagina successiva.Gets or sets the text to display for the next-page button.

PageButtonCount

Ottiene o imposta il numero di pagine da visualizzare nel pager quando la proprietà Mode è impostata sul valore Numeric oppure NumericFirstLast.Gets or sets the number of page buttons to display in the pager when the Mode property is set to the Numeric or NumericFirstLast value.

Position

Ottiene o imposta un valore che specifica il posizione in cui viene visualizzato il pager.Gets or sets a value that specifies the location where the pager is displayed.

PreviousPageImageUrl

Ottiene o imposta l'URL di un'immagine da visualizzare per il pulsante di collegamento alla pagina precedente.Gets or sets the URL to an image to display for the previous-page button.

PreviousPageText

Ottiene o imposta il testo da visualizzare per il pulsante di collegamento alla pagina precedente.Gets or sets the text to display for the previous page button.

Visible

Ottiene o imposta un valore che indica se i controlli per il paging sono visualizzati in un controllo che supporta la paginazione.Gets or sets a value indicating whether the paging controls are displayed in a control that supports pagination.

Metodi

Equals(Object)

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

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

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

(Ereditato da Object)
MemberwiseClone()

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

(Ereditato da Object)
ToString()

Consente di recuperare la rappresentazione in forma di stringa di un oggetto PagerSettings.Retrieves the string representation of a PagerSettings object.

Eventi

PropertyChanged

Viene generato quando vengono modificati i valori di una proprietà di un oggetto PagerSettings.Occurs when a property of a PagerSettings object changes values.

Implementazioni dell'interfaccia esplicita

IStateManager.IsTrackingViewState

Ottiene un valore che indica se il controllo server tiene traccia delle modifiche allo stato di visualizzazione.Gets a value that indicates whether the server control is tracking its view state changes.

IStateManager.LoadViewState(Object)

Consente di caricare lo stato di visualizzazione dell'oggetto PagerSettings precedentemente salvato.Loads the previously saved view state of the PagerSettings object.

IStateManager.SaveViewState()

Salva lo stato di visualizzazione corrente dell'oggetto PagerSettings.Saves the current view state of the PagerSettings object.

IStateManager.TrackViewState()

Viene contrassegnato il punto iniziale per la registrazione e il salvataggio delle modifiche dello stato di visualizzazione nell'oggetto PagerSettings.Marks the starting point at which to begin tracking and saving view state changes to the PagerSettings object.

Si applica a

Vedi anche