GridView.AllowPaging Propriété

Définition

Obtient ou définit une valeur indiquant si la fonctionnalité de pagination est activée.

public:
 virtual property bool AllowPaging { bool get(); void set(bool value); };
public virtual bool AllowPaging { get; set; }
member this.AllowPaging : bool with get, set
Public Overridable Property AllowPaging As Boolean

Valeur de propriété

true si la fonctionnalité de pagination est activée ; sinon, false. La valeur par défaut est false.

Exemples

L’exemple suivant montre comment utiliser la AllowPaging propriété pour activer de manière déclarative la fonctionnalité de pagination dans le 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>GridView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView AllowPaging Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">
                
        <pagersettings mode="Numeric"
          position="Bottom"           
          pagebuttoncount="10"/>
                      
        <pagerstyle backcolor="LightBlue"
          height="30px"
          verticalalign="Bottom"
          horizontalalign="Center"/>
                
      </asp:gridview>
            
      <!-- 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="CustomersSource"
        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>GridView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView AllowPaging Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">
                
        <pagersettings mode="Numeric"
          position="Bottom"           
          pagebuttoncount="10"/>
                      
        <pagerstyle backcolor="LightBlue"
          height="30px"
          verticalalign="Bottom"
          horizontalalign="Center"/>
                
      </asp:gridview>
            
      <!-- 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="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
        
    </form>
  </body>
</html>

Remarques

Au lieu d’afficher tous les enregistrements dans la source de données en même temps, le GridView contrôle peut décomposer automatiquement les enregistrements en pages. Si la source de données prend en charge la fonctionnalité de pagination, le GridView contrôle peut en tirer parti et fournir des fonctionnalités de pagination intégrées. La fonctionnalité de pagination peut être utilisée avec n’importe quel objet de source de données qui prend en charge l’interface System.Collections.ICollection ou une source de données qui prend en charge la fonctionnalité de pagination.

Pour activer la fonctionnalité de pagination, définissez la propriété sur AllowPagingtrue. Par défaut, le GridView contrôle affiche 10 enregistrements sur une page à la fois. Vous pouvez modifier le nombre d’enregistrements affichés sur une page en définissant la PageSize propriété . Pour déterminer le nombre total de pages requises pour afficher le contenu de la source de données, utilisez la PageCount propriété . Vous pouvez déterminer l’index de la page actuellement affichée à l’aide de la PageIndex propriété .

Lorsque la pagination est activée, une ligne supplémentaire appelée ligne de pagineur s’affiche automatiquement dans le GridView contrôle. La ligne du pagineur contient des contrôles qui permettent à l’utilisateur d’accéder aux autres pages. Vous pouvez contrôler les paramètres de la ligne du pagineur (par exemple, le mode d’affichage du pagineur, le nombre de liens de page à afficher à la fois et les étiquettes de texte du contrôle de pagineur) à l’aide de la PagerSettings propriété . La ligne du pagineur peut être affichée en haut, en bas ou à la fois en haut et en bas du contrôle en définissant la Position propriété . Vous pouvez également choisir parmi l’un des quatre modes d’affichage du pagineur intégré en définissant la Mode propriété . Le tableau suivant décrit les modes d’affichage intégrés.

Mode Description
PagerButton.NextPrevious Ensemble de contrôles de pagination constitué de boutons précédents et suivants.
PagerButton.NextPreviousFirstLast Ensemble de contrôles de pagination constitué de boutons précédents, suivants, premier et dernier.
PagerButton.Numeric Ensemble de contrôles de pagination comprenant des boutons de lien numéroté permettant d'accéder directement aux pages. Il s’agit du mode par défaut ;
PagerButton.NumericFirstLast Ensemble de contrôles de pagination composé de boutons numérotés et de premier et dernier lien.

Pour contrôler l’apparence de la ligne du pagineur (y compris sa couleur d’arrière-plan, sa couleur de police et sa position), utilisez la PagerStyle propriété .

Notes

Le GridView contrôle masque automatiquement la ligne du pagineur lorsque la source de données ne contient qu’une seule page d’enregistrements.

Le GridView contrôle vous permet également de définir un modèle personnalisé pour la ligne du pagineur. Pour plus d’informations sur la création d’un modèle de ligne de pagineur personnalisé, consultez PagerTemplate.

Le GridView contrôle fournit plusieurs événements que vous pouvez utiliser pour effectuer une action personnalisée lors de la pagination. Le tableau suivant répertorie les événements disponibles.

Événement Description
PageIndexChanged Se produit lorsqu'un clic est effectué sur un des boutons de pagineur, mais une fois que le contrôle GridView a géré l'opération de pagination. Cet événement est couramment utilisé lorsque vous devez effectuer une tâche après que l’utilisateur accède à une autre page du contrôle.
PageIndexChanging Se produit lorsqu'un clic est effectué sur des boutons du pagineur et avant que le contrôle GridView n'ait géré l'opération de pagination. Cet événement est souvent utilisé pour annuler l’opération de pagination.

S’applique à

Voir aussi