PagerSettings.Mode Propriété

Référence

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.

Obtient ou définit le mode dans lequel afficher les contrôles de pagineur 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 valeurs de l'objet PagerButtons. La valeur par défaut est PagerButtons.Numeric.

Exceptions

ArgumentOutOfRangeException

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

Exemples

L’exemple de code suivant montre comment utiliser la propriété pour spécifier que la Mode 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 pour les 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 first-link et last-link.

Lorsque la Mode propriété est définie sur le NextPrevioustexte NextPreviousFirstLast NumericFirstLast personnalisé des boutons non numériques, vous pouvez spécifier le texte personnalisé pour les boutons non numériques en définissant 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 de 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 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 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.

Notes

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

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

S’applique à

Partager via