Partager via

PagerSettings.Mode Propriété

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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

public:
 property System::Web::UI::WebControls::PagerButtons Mode { System::Web::UI::WebControls::PagerButtons get(); void set(System::Web::UI::WebControls::PagerButtons value); };
public System.Web.UI.WebControls.PagerButtons Mode { get; set; }
member this.Mode : System.Web.UI.WebControls.PagerButtons with get, set
Public Property Mode As PagerButtons

Valeur de propriété

PagerButtons

Une des PagerButtons valeurs. La valeur par défaut est PagerButtons.Numeric.

Exceptions

ArgumentOutOfRangeException

La Mode valeur est définie sur une valeur qui n’est pas l’une des PagerButtons valeurs.

Exemples

L’exemple de code suivant montre comment utiliser la Mode propriété pour spécifier que la ligne du pagineur d’un GridView contrôle doit afficher des boutons numériques.


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


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

Remarques

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

Mode Description
NextPrevious Boutons page précédente et page suivante.
NextPreviousFirstLast Page précédente, page suivante, première page et boutons de dernière page.
Numeric Boutons de lien numérotés pour accéder directement aux pages.
NumericFirstLast Boutons numérotés et premier lien et dernier lien.

Lorsque la propriété est définie sur la valeur ou le ModeNextPrevioustexte NextPreviousFirstLastNumericFirstLast personnalisé des boutons non numériques, vous pouvez définir 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 page suivante.
LastPageText Texte du bouton de la dernière page.

En guise d’alternative, vous pouvez également afficher des images pour les boutons non numériques en définissant les propriétés indiquées 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.

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

S’applique à

Voir aussi