PagerSettings Classe

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 le 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	Boutons numérotés, premier lien et dernier lien.

Lorsque la Mode propriété est définie sur le NextPreviousou la valeur, NextPreviousFirstLast NumericFirstLast vous pouvez personnaliser le texte des boutons non numériques en définissant les propriétés affiché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 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 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.

Note

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é en tant que texte de remplacement pour l’image. Sur les navigateurs qui prennent en charge les info-bulles, ce texte s’affiche également sous forme d’info-bulle pour le bouton correspondant.

Lorsque la Mode propriété est définie sur la Numeric ou NumericFirstLast la 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

Nom	Description
PagerSettings()	Initialise une nouvelle instance de la classe PagerSettings.

Propriétés

Nom	Description
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 pagination 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 Mode propriété est définie sur la ou NumericFirstLast la Numeric valeur.
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 page précédente.
PreviousPageText	Obtient ou définit le texte à afficher pour le bouton de page précédent.
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

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

Événements

Nom	Description
PropertyChanged	Se produit lorsqu’une propriété d’un PagerSettings objet change de valeurs.

Implémentations d’interfaces explicites

Nom	Description
IStateManager.IsTrackingViewState	Obtient une valeur qui indique si le contrôle serveur suit ses modifications d’état d’affichage.
IStateManager.LoadViewState(Object)	Charge l’état d’affichage précédemment enregistré de l’objet PagerSettings .
IStateManager.SaveViewState()	Enregistre l’état d’affichage actuel de l’objet PagerSettings .
IStateManager.TrackViewState()	Marque le point de départ auquel commencer le suivi et l’enregistrement des modifications de l’état d’affichage de l’objet PagerSettings .

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?