GridView.AllowPaging, propriété
Assembly : System.Web (dans system.web.dll)
/** @property */ public boolean get_AllowPaging () /** @property */ public void set_AllowPaging (boolean value)
public function get AllowPaging () : boolean public function set AllowPaging (value : boolean)
Valeur de la propriété
true si la fonctionnalité de pagination est activée ; sinon false. La valeur par défaut est false.Au lieu d'afficher en même temps tous les enregistrements dans la source de données, le contrôle GridView peut scinder automatiquement les enregistrements en pages. Si la source de données prend en charge la fonctionnalité de pagination, le contrôle GridView peut en tirer parti et fournir la fonctionnalité intégrée de pagination. La fonctionnalité de pagination peut être utilisée avec un 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, affectez la valeur true à la propriété AllowPaging. Par défaut, le contrôle GridView affiche 10 enregistrements sur une page. Vous pouvez modifier le nombre d'enregistrements affichés sur une page en définissant la propriété PageSize. Pour déterminer le nombre total de pages requis pour afficher le contenu de la source de données, utilisez la propriété PageCount. Vous pouvez déterminer l'index de la page actuellement affichée à l'aide de la propriété PageIndex.
Lorsque la pagination est activée, une ligne supplémentaire appelée ligne de pagineur est affichée automatiquement dans le contrôle GridView. La ligne du pagineur contient des contrôles permettant à l'utilisateur de naviguer vers d'autres pages. Vous pouvez contrôler les paramètres de la ligne du pagineur (tels que le mode d'affichage du pagineur, le nombre de liens de page à afficher à la fois et les étiquettes de texte de contrôle du pagineur) en utilisant la propriété PagerSettings. La ligne de pagineur peut être affichée en haut, en bas ou à la fois en haut et en bas du contrôle en définissant la propriété Position. Vous pouvez également sélectionner un des quatre modes d'affichage de pagineur intégrés en définissant la propriété Mode. Le tableau suivant décrit les modes d'affichage intégrés.
| Mode | Description |
|---|---|
| PagerButton.NextPrevious | Ensemble des contrôles de pagination comprenant les boutons Précédent et Suivant. |
| PagerButton.NextPreviousFirstLast | Ensemble de contrôles de pagination comprenant des boutons Précédent, Suivant, 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 comprenant des boutons de lien numéroté, premier et dernier. |
Pour contrôler l'apparence de la ligne de pagineur (y compris sa couleur d'arrière-plan, sa couleur de police et sa position), utilisez la propriété PagerStyle.
 Remarque |
|---|
| Le contrôle GridView masque automatiquement la ligne de pagineur lorsque la source de données contient moins de deux enregistrements. |
Le contrôle GridView vous permet également de définir un modèle personnalisé pour la ligne de pagineur. Pour plus d'informations sur la création d'un modèle personnalisé de ligne de pagineur, consultez PagerTemplate.
Le contrôle GridView fournit plusieurs événements permettant d'exécuter une action personnalisée lors de la pagination. Le tableau suivant répertorie les événements disponibles.
| Événement | Description |
|---|---|
| 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 exécuter une tâche une fois que l'utilisateur a navigué vers une page différente dans le contrôle. | |
| 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. |
| Rubrique | Emplacement |
|---|---|
| Comment : activer la mise en page par défaut dans le contrôle serveur Web GridView | Génération d'applications Web ASP.NET dans Visual Studio |
| Comment : activer la mise en page par défaut dans le contrôle serveur Web GridView | Génération d'applications Web ASP.NET dans Visual Studio |
L'exemple de code suivant montre comment utiliser la propriété AllowPaging pour activer de façon déclarative la fonctionnalité de pagination dans le contrôle GridView.
<%@ Page language="C#" %> <html> <body> <form 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>
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition
Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.
