DetailsView.AllowPaging Propriété
Définition
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, setPublic Overridable Property AllowPaging As BooleanValeur de propriété
true pour activer la fonctionnalité de pagination ; sinon, false. La valeur par défaut est false.
Exemples
L’exemple de code suivant montre comment utiliser la AllowPaging propriété pour activer les fonctionnalités de pagination du DetailsView 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>DetailsView AllowPaging Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>DetailsView AllowPaging Example</h3>
<asp:detailsview id="StoresDetailView"
datasourceid="Customers"
autogeneraterows="true"
allowpaging="true"
runat="server">
<headerstyle backcolor="Navy"
forecolor="White"/>
<pagersettings mode="NextPreviousFirstLast"
firstpagetext="First"
lastpagetext="Last"
nextpagetext="Next"
previouspagetext="Prev"/>
<pagerstyle forecolor="White"
backcolor="Blue"
font-names="Arial"
font-size="8" />
</asp:detailsview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:SqlDataSource ID="Customers" runat="server"
ConnectionString=
"<%$ ConnectionStrings:NorthwindConnectionString %>"
SelectCommand="SELECT [CompanyName], [ContactName],
[CustomerID] FROM [Customers]">
</asp:SqlDataSource>
</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>DetailsView AllowPaging Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>DetailsView AllowPaging Example</h3>
<asp:detailsview id="StoresDetailView"
datasourceid="Customers"
autogeneraterows="true"
allowpaging="true"
runat="server">
<headerstyle backcolor="Navy"
forecolor="White"/>
<pagersettings mode="NextPreviousFirstLast"
firstpagetext="First"
lastpagetext="Last"
nextpagetext="Next"
previouspagetext="Prev"/>
<pagerstyle forecolor="White"
backcolor="Blue"
font-names="Arial"
font-size="8" />
</asp:detailsview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:SqlDataSource ID="Customers" runat="server"
ConnectionString=
"<%$ ConnectionStrings:NorthwindConnectionString %>"
SelectCommand="SELECT [CompanyName], [ContactName],
[CustomerID] FROM [Customers]">
</asp:SqlDataSource>
</form>
</body>
</html>
Remarques
Le DetailsView contrôle dispose de fonctionnalités de pagination intégrées, qui permettent à un utilisateur d’accéder à un autre enregistrement dans la source de données.
Le DetailsView contrôle peut effectuer à la fois l’interface utilisateur et la pagination de source de données. La fonctionnalité de pagination de l’interface utilisateur peut être utilisée avec n’importe quel objet de source de données qui prend en charge l’interface System.Collections.ICollection . Pour chaque opération de pagination, le DetailsView contrôle interroge la source de données pour l’ensemble de la collection de données et sélectionne la ligne à afficher, en ignorant essentiellement les données restantes.
Si une source de données implémente DataSourceView et que la CanPage propriété retourne true, le contrôle utilise la DetailsView pagination de la source de données au lieu de la pagination de l’interface utilisateur. Dans ce cas, le DetailsView contrôle interroge uniquement la ligne nécessaire pour chaque opération de pagination. Par conséquent, la pagination de source de données est plus efficace que la pagination de l’interface utilisateur. Seul l’objet prend en charge la ObjectDataSourceView pagination de la source de données sans modification.
Pour activer la fonctionnalité de pagination, définissez la AllowPaging propriété truesur . Vous pouvez déterminer le nombre total d’éléments dans la source de données sous-jacente à l’aide de la PageCount propriété. Pour déterminer l’index de l’élément actuellement affiché, utilisez la PageIndex propriété.
Lorsque la pagination est activée, une ligne supplémentaire appelée ligne de pagineur s’affiche automatiquement dans le DetailsView contrôle. La ligne du pagineur contient les contrôles de navigation de page et peut être affichée en haut, en bas ou en haut et en bas du contrôle. La ligne du pagineur comporte deux modes d’affichage de paginateur intégrés : les pages numérotées et les liens de page suivants et précédents (par défaut). Le mode pages numérotées affiche des liens pour les pages individuelles, ce qui permet à l’utilisateur d’accéder à une page spécifique. Le mode liens suivant et précédent affiche les contrôles qui permettent à l’utilisateur d’accéder à la page suivante ou précédente.
Notes
Le DetailsView contrôle masque automatiquement la ligne du pagineur lorsque la source de données contient moins de deux enregistrements.
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 l’étiquette de texte du contrôle de pagineur) à l’aide de la PagerSettings propriété. 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é. Le DetailsView 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 DetailsView 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 DetailsView a géré 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 à un autre enregistrement dans le contrôle. |
| PageIndexChanging | Se produit lorsqu'un clic est effectué sur des boutons du pagineur et avant que le contrôle DetailsView n'ait géré l'opération de pagination. Cet événement est souvent utilisé pour annuler l’opération de pagination. |
La valeur est AllowPaging stockée dans l’état d’affichage.