Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais
Cette documentation est archivée et n’est pas conservée.

PagerSettings, classe

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.

System.Object
  System.Web.UI.WebControls.PagerSettings

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans System.Web.dll)

[TypeConverterAttribute(typeof(ExpandableObjectConverter))]
public sealed class PagerSettings : IStateManager

Le type PagerSettings expose les membres suivants.

  NomDescription
Méthode publiquePagerSettingsInitialise une nouvelle instance de la classe PagerSettings.
Début

  NomDescription
Propriété publiqueFirstPageImageUrlObtient ou définit l'URL d'une image à afficher pour le bouton de première page.
Propriété publiqueFirstPageTextObtient ou définit le texte à afficher pour le bouton de première page.
Propriété publiqueLastPageImageUrlObtient ou définit l'URL d'une image à afficher pour le bouton de dernière page.
Propriété publiqueLastPageTextObtient ou définit le texte à afficher pour le bouton de dernière page.
Propriété publiqueModeObtient ou définit le mode dans lequel afficher les contrôles de pagineur dans un contrôle qui prend en charge la pagination.
Propriété publiqueNextPageImageUrlObtient ou définit l'URL d'une image à afficher pour le bouton de page suivante.
Propriété publiqueNextPageTextObtient ou définit le texte à afficher pour le bouton de page suivante.
Propriété publiquePageButtonCountObtient ou définit le nombre de boutons de page à afficher dans le pagineur lorsque la propriété Mode a la valeur Numeric ou NumericFirstLast.
Propriété publiquePositionObtient ou définit une valeur qui spécifie l'emplacement où le pagineur est affiché.
Propriété publiquePreviousPageImageUrlObtient ou définit l'URL d'une image à afficher pour le bouton de page précédente.
Propriété publiquePreviousPageTextObtient ou définit le texte à afficher pour le bouton de page précédente.
Propriété publiqueVisibleObtient 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.
Début

  NomDescription
Méthode publiqueEquals(Object)Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode protégéeFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiqueGetHashCodeSert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode publiqueToStringRécupère la représentation sous forme de chaîne d'un objet PagerSettings. (Substitue Object.ToString().)
Début

  NomDescription
Événement publicPropertyChangedSe produit lorsqu'une propriété d'un objet PagerSettings modifie des valeurs.
Début

  NomDescription
Implémentation d'interface explicitePropriété privéeIStateManager.IsTrackingViewStateObtient une valeur qui indique si le contrôle serveur effectue le suivi des modifications apportées à son état d'affichage.
Implémentation d'interface expliciteMéthode privéeIStateManager.LoadViewStateInfrastructure. Charge l'état d'affichage enregistré précédemment de l'objet PagerSettings.
Implémentation d'interface expliciteMéthode privéeIStateManager.SaveViewStateInfrastructure. Enregistre l'état d'affichage actuel de l'objet PagerSettings.
Implémentation d'interface expliciteMéthode privéeIStateManager.TrackViewStateInfrastructure. Marque le point de départ du suivi et de l'enregistrement des modifications d'état d'affichage apportées à l'objet PagerSettings.
Début

Les contrôles qui prennent en charge la pagination (tels que les contrôles GridView, DetailsView et FormView) peuvent afficher un ensemble de contrôles appelé le pagineur qui permet à l'utilisateur de parcourir les pages du contrôle. La classe PagerSettings 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 propriété PagerSettings du contrôle. Vous pouvez personnaliser le pagineur en définissant les propriétés de l'objet PagerSettings.

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

Mode

Description

NextPrevious

Boutons de page précédente et de page suivante.

NextPreviousFirstLast

Boutons de page précédente, de page suivante, de première page et de dernière page.

Numeric

Boutons de lien numérotés pour accéder directement aux pages.

NumericFirstLast

Boutons de lien numérotés, de premier lien et de dernier lien.

Lorsque la propriété Mode a la valeur NextPreviousNextPreviousFirstLast ou NumericFirstLast, vous pouvez personnaliser le texte des boutons non numérotés en définissant les propriétés affichées dans le tableau suivant.

Property

Description

FirstPageText

Texte du bouton de première page.

PreviousPageText

Texte du bouton de page précédente.

NextPageText

Texte du bouton de page suivante.

LastPageText

Texte du bouton de dernière page.

Une autre possibilité consiste à afficher des images de boutons non numérotés en définissant les propriétés comme indiqué dans le tableau suivant.

Property

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.

RemarqueRemarque

Lorsqu'une propriété d'image est définie, la propriété Text correspondante agit en tant que texte de remplacement pour l'image. Par exemple, lorsque la propriété FirstPageImageUrl est définie, le texte spécifié par la propriété FirstPageText est affiché en tant que texte de remplacement pour l'image. Dans les navigateurs qui prennent en charge la fonctionnalité Info-bulles, ce texte s'affiche également sous forme d'info-bulle pour le bouton correspondant.

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

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 propriété Position. Pour afficher ou masquer le pagineur, utilisez la propriété Visible.

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



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



.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Afficher: