Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.

Traduction

Source

Ce sujet n'a pas encore été évalué - Évaluez ce sujet

PagerSettings.Mode, propriété

.NET Framework 4.5

Autres versions

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

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

Syntaxe

C++

public PagerButtons Mode { get; set; }

Valeur de propriété

Type : System.Web.UI.WebControls.PagerButtons
Une des valeurs de PagerButtons. La valeur par défaut est PagerButtons.Numeric.

Exceptions

Exception	Condition
ArgumentOutOfRangeException	Une valeur ne faisant pas partie des valeurs PagerButtons est assignée à Mode.

Notes

Les contrôles qui prennent en charge la pagination fournissent plusieurs modes dans lesquels afficher les contrôles de pagination. Utilisez la propriété Mode pour spécifier le mode. Le tableau suivant décrit les différents modes pour les contrôles de pagination.

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

Lorsque la propriété Mode a la valeur NextPreviousNextPreviousFirstLast ou NumericFirstLast, vous pouvez spécifier le texte personnalisé des boutons non numérotés 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 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.

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.

Remarque
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.

Remarque

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.

La valeur de cette propriété est stockée dans l'état d'affichage.

Exemples

L'exemple de code suivant illustre l'utilisation de la propriété Mode pour spécifier que la ligne de pagineur d'un contrôle GridView doit afficher des boutons numérotés.



<%@ 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="NumericFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            pagebuttoncount="5"  
            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>

Informations de version

.NET Framework

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

Plateformes

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

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.

Voir aussi