Partager via


PagerSettings Classe

Définition

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
PagerSettings
Attributs
Implémente

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 à

Voir aussi