PagerSettings Classe

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Représente les propriétés des contrôles de pagination dans un contrôle qui prend en charge la pagination. Cette classe ne peut pas être héritée.

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

Héritage: Object
PagerSettings

Attributs: TypeConverterAttribute

Implémente: IStateManager

Exemples

L’exemple de code suivant montre comment utiliser l’objet PagerSettings contenu dans la PagerSettings propriété pour personnaliser le texte des boutons affichés dans la ligne de pagineur d’un GridView contrôle.


<%@ 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>

Remarques

Les contrôles qui prennent en charge la pagination (par exemple, le GridView, DetailsViewet FormView les contrôles) peuvent afficher un ensemble de contrôles appelés pagineur qui permet à l’utilisateur de parcourir les pages dans le contrôle. La PagerSettings classe est utilisée par ces contrôles pour représenter les propriétés du pagineur. En général, l’objet PagerSettings est stocké dans la PagerSettings propriété du contrôle. Vous pouvez personnaliser le pagineur en définissant les propriétés de l’objet PagerSettings .

Le pagineur prend en charge plusieurs modes d’affichage différents. Pour spécifier le mode dans lequel afficher le pagineur, définissez la Mode propriété. Le tableau suivant décrit les différents modes.

Mode	Description
NextPrevious	Boutons page précédente et page suivante.
NextPreviousFirstLast	Page précédente, page suivante, première page et derniers boutons -page.
Numeric	Boutons de lien numérotés pour accéder directement aux pages.
NumericFirstLast	Liens numérotés, premier lien et boutons de dernier lien.

Lorsque la Mode propriété est définie sur le NextPrevious, ou NumericFirstLast la valeur, NextPreviousFirstLastvous pouvez personnaliser le texte des boutons non numériques en définissant les propriétés indiquées dans le tableau suivant.

Propriété	Description
FirstPageText	Texte du bouton de première page.
PreviousPageText	Texte du bouton page précédente.
NextPageText	Texte du bouton de page suivante.
LastPageText	Texte du bouton de la dernière page.

Vous pouvez également afficher des images pour les boutons non numériques en définissant les propriétés comme indiqué dans le tableau suivant.

Propriété	Description
FirstPageImageUrl	URL d'une image à afficher pour le bouton de première page.
PreviousPageImageUrl	URL d'une image à afficher pour le bouton de page précédente.
NextPageImageUrl	URL d'une image à afficher pour le bouton de page suivante.
LastPageImageUrl	URL d'une image à afficher pour le bouton de dernière page.

Notes

Lorsqu’une propriété d’image est définie, la propriété de texte correspondante agit comme texte de remplacement pour l’image. Par exemple, lorsque la FirstPageImageUrl propriété est définie, le texte spécifié par la FirstPageText propriété est affiché comme texte de remplacement pour l’image. Sur les navigateurs qui prennent en charge les info-bulles, ce texte est également affiché sous forme d’info-bulle pour le bouton correspondant.

Lorsque la propriété est définie sur la ou NumericFirstLast la Mode Numeric valeur, vous pouvez spécifier le nombre de boutons de page à afficher dans le pagineur en définissant la PageButtonCount propriété.

Le pagineur peut être affiché en haut, en bas ou en haut et en bas d’un contrôle. Pour spécifier la position du pagineur, définissez la Position propriété. Pour afficher ou masquer le pagineur, utilisez la Visible propriété.

Constructeurs

PagerSettings()

Initialise une nouvelle instance de la classe PagerSettings.

Propriétés

FirstPageImageUrl	Obtient ou définit l'URL d'une image à afficher pour le bouton de première page.
FirstPageText	Obtient ou définit le texte à afficher pour le bouton de première page.
LastPageImageUrl	Obtient ou définit l'URL d'une image à afficher pour le bouton de dernière page.
LastPageText	Obtient ou définit le texte à afficher pour le bouton de dernière page.
Mode	Obtient ou définit le mode dans lequel afficher les contrôles de pagineur dans un contrôle qui prend en charge la pagination.
NextPageImageUrl	Obtient ou définit l'URL d'une image à afficher pour le bouton de page suivante.
NextPageText	Obtient ou définit le texte à afficher pour le bouton de page suivante.
PageButtonCount	Obtient ou définit le nombre de boutons de page à afficher dans le pagineur lorsque la propriété Mode a la valeur Numeric ou NumericFirstLast.
Position	Obtient ou définit une valeur qui spécifie l'emplacement où le pagineur est affiché.
PreviousPageImageUrl	Obtient ou définit l'URL d'une image à afficher pour le bouton de page précédente.
PreviousPageText	Obtient ou définit le texte à afficher pour le bouton de page précédente.
Visible	Obtient ou définit une valeur indiquant si les contrôles de pagination sont affichés dans un contrôle qui prend en charge la pagination.

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Récupère la représentation sous forme de chaîne d'un objet PagerSettings.

Événements

PropertyChanged

Se produit lorsqu'une propriété d'un objet PagerSettings modifie des valeurs.

Implémentations d’interfaces explicites

IStateManager.IsTrackingViewState	Obtient une valeur qui indique si le contrôle serveur effectue le suivi des modifications apportées à son état d'affichage.
IStateManager.LoadViewState(Object)	Charge l'état d'affichage enregistré précédemment de l'objet PagerSettings.
IStateManager.SaveViewState()	Enregistre l'état d'affichage actuel de l'objet PagerSettings.
IStateManager.TrackViewState()	Marque le point de départ du suivi et de l'enregistrement des modifications d'état d'affichage apportées à l'objet PagerSettings.

S’applique à