GridView.AllowPaging Propriété

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 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é

Boolean

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 automatiquement décomposer 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 AllowPaging propriété sur true. 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 du 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 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és de boutons précédents et suivants.
`PagerButton.NextPreviousFirstLast`	Ensemble de contrôles de pagination constitués de boutons précédents, suivants, premier et dernier.
`PagerButton.Numeric`	Ensemble de contrôles de pagination composés de boutons de lien numérotés pour accéder directement aux pages. Il s’agit du mode par défaut ;
`PagerButton.NumericFirstLast`	Ensemble de contrôles de pagination composés de boutons numérotés et 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é.

Note

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 des boutons du pagineur est cliqué, mais après que le GridView contrôle gère l’opération de pagination. Cet événement est couramment utilisé lorsque vous devez effectuer une tâche une fois que l’utilisateur accède à une autre page du contrôle.
PageIndexChanging	Se produit lorsqu’un des boutons du pagineur est cliqué, mais avant que le GridView contrôle gère l’opération de pagination. Cet événement est souvent utilisé pour annuler l’opération de pagination.

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?