Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

PagerSettings classe

 

Date de publication : novembre 2016

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.

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

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

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

NomDescription
System_CAPS_pubmethodPagerSettings()

Initialise une nouvelle instance de la classe PagerSettings.

NomDescription
System_CAPS_pubpropertyFirstPageImageUrl

Obtient ou définit l’URL vers une image à afficher pour le bouton de première page.

System_CAPS_pubpropertyFirstPageText

Obtient ou définit le texte à afficher pour le bouton de première page.

System_CAPS_pubpropertyLastPageImageUrl

Obtient ou définit l’URL vers une image à afficher pour le bouton de dernière page.

System_CAPS_pubpropertyLastPageText

Obtient ou définit le texte à afficher pour le bouton de dernière page.

System_CAPS_pubpropertyMode

Obtient ou définit le mode dans lequel afficher les contrôles de pagineur dans un contrôle qui prend en charge la pagination.

System_CAPS_pubpropertyNextPageImageUrl

Obtient ou définit l’URL vers une image à afficher pour le bouton de page suivante.

System_CAPS_pubpropertyNextPageText

Obtient ou définit le texte à afficher pour le bouton de page suivante.

System_CAPS_pubpropertyPageButtonCount

Obtient ou définit le nombre de boutons de page à afficher dans le pagineur lorsque la Mode est définie sur le Numeric ou NumericFirstLast valeur.

System_CAPS_pubpropertyPosition

Obtient ou définit une valeur qui spécifie l’emplacement où le pagineur est affiché.

System_CAPS_pubpropertyPreviousPageImageUrl

Obtient ou définit l’URL vers une image à afficher pour le bouton de page précédente.

System_CAPS_pubpropertyPreviousPageText

Obtient ou définit le texte à afficher pour le bouton de page précédente.

System_CAPS_pubpropertyVisible

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.

NomDescription
System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodToString()

Récupère la représentation sous forme de chaîne d’un PagerSettings objet.(Remplace Object.ToString().)

NomDescription
System_CAPS_pubeventPropertyChanged

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

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.LoadViewState(Object)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Charge l’état d’affichage précédemment enregistré de le PagerSettings objet.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.SaveViewState()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Enregistre l’état d’affichage actuel du PagerSettings objet.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.TrackViewState()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Marque le point de départ à partir duquel commencer le suivi et l’enregistrement de l’état d’affichage change pour la PagerSettings objet.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIStateManager.IsTrackingViewState

Obtient une valeur qui indique si le contrôle serveur est suivi des modifications de son état d’affichage.

Les contrôles qui prennent en charge la pagination (tels que le GridView, DetailsView, et FormView contrôles) peuvent afficher un ensemble de contrôles appelé la radiomessagerie 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 de la radiomessagerie. En général, la PagerSettings l’objet est stocké dans le PagerSettings propriété du contrôle. Vous pouvez personnaliser le pagineur en définissant les propriétés de la PagerSettings objet.

Le pagineur prend en charge différents modes d’affichage. 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 de page précédente et page suivante.

NextPreviousFirstLast

Page précédente, page suivante, première page et dernière - boutons de page.

Numeric

Numérotés de boutons de lien pour accéder aux pages directement.

NumericFirstLast

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

Lorsque la Mode est définie sur le NextPrevious, NextPreviousFirstLast, 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.

Comme alternative, vous pouvez également 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 vers une image à afficher pour le bouton de première page.

PreviousPageImageUrl

URL vers une image à afficher pour le bouton de page précédente.

NextPageImageUrl

URL vers une image à afficher pour le bouton de page suivante.

LastPageImageUrl

URL vers une image à afficher pour le bouton de dernière page.

System_CAPS_noteRemarque

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

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

La radiomessagerie peut être affichée en haut, bas, ou en haut et 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é.

L’exemple de code suivant montre comment utiliser le PagerSettings objet contenu dans le PagerSettings propriété pour personnaliser le texte des boutons qui sont affichent dans la ligne de pagineur 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>

.NET Framework
Disponible depuis 2.0

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: