Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. |
Traduction
Source
|
DataPagerField, classe
Sert de classe de base pour les types de champ du pagineur de données, qui représentent un contrôle de navigation pour le contrôle DataPager.
System.Web.UI.WebControls.DataPagerField
System.Web.UI.WebControls.NextPreviousPagerField
System.Web.UI.WebControls.NumericPagerField
System.Web.UI.WebControls.TemplatePagerField
Assembly : System.Web.Extensions (dans System.Web.Extensions.dll)
Le type DataPagerField expose les membres suivants.
| Nom | Description | |
|---|---|---|
|
DataPager | Obtient une référence au pagineur de données auquel l'objet DataPagerField est associé. |
|
IsTrackingViewState | Obtient une valeur qui indique si l'objet DataPagerField suit les modifications apportées à son état d'affichage. |
|
QueryStringHandled | Obtient ou définit une valeur qui indique si le champ de chaîne de requête a été évalué. |
|
QueryStringValue | Obtient la valeur du champ de chaîne de requête auprès de l'URL de la demande. |
|
ViewState | Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un objet DataPagerField parmi plusieurs demandes pour la même page. |
|
Visible | Obtient ou définit une valeur indiquant si un champ du pagineur de données est restitué. |
| Nom | Description | |
|---|---|---|
|
CloneField | Infrastructure. Crée une copie de l'objet actuel dérivé de DataPagerField. |
|
CopyProperties | Copie les propriétés de l'objet actuel dérivé de DataPagerField vers l'objet DataPagerField spécifié. |
|
CreateDataPagers | En cas de substitution dans une classe dérivée, crée les contrôles d'interface utilisateur pour l'objet du champ du pagineur de données et les ajoute au conteneur spécifié. |
|
CreateField | En cas de substitution dans une classe dérivée, crée une instance d'une classe qui implémente DataPagerField. |
|
Equals(Object) | Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.) |
|
Finalize | Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.) |
|
GetHashCode | Sert de fonction de hachage pour un type particulier. (Hérité de Object.) |
|
GetQueryStringNavigateUrl | Crée une URL qui contient un champ de chaîne de requête contenant le numéro de page spécifié. |
|
GetType | Obtient le Type de l'instance actuelle. (Hérité de Object.) |
|
HandleEvent | En cas de substitution dans une classe dérivée, gère des événements qui se produisent dans l'objet du champ du pagineur des données. |
|
LoadViewState | Restaure des informations d'état de vue enregistrées précédemment. |
|
MemberwiseClone | Crée une copie superficielle de l'objet Object actif. (Hérité de Object.) |
|
OnFieldChanged | Déclenche l'événement FieldChanged. |
|
SaveViewState | Enregistre les modifications apportées à l'état de vue de l'objet DataPagerField. |
|
ToString | Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.) |
|
TrackViewState | L'objet DataPagerField effectue alors le suivi des modifications de son état d'affichage afin qu'elles puissent être stockées dans la propriété ViewState du contrôle et persister entre les demandes pour la même page. |
| Nom | Description | |
|---|---|---|
|
IStateManager.IsTrackingViewState | Infrastructure. Obtient une valeur qui indique si l'objet DataPagerField suit les modifications apportées à son état d'affichage. |
|
IStateManager.LoadViewState | Infrastructure. Restaure des informations d'état de vue enregistrées précédemment. |
|
IStateManager.SaveViewState | Infrastructure. Enregistre les modifications apportées à l'état de vue de l'objet DataPagerField. |
|
IStateManager.TrackViewState | Infrastructure. L'objet DataPagerField effectue alors le suivi des modifications de son état d'affichage afin qu'elles puissent être stockées dans la propriété ViewState du contrôle et persister entre les demandes pour la même page. |
La classe DataPagerField sert de classe de base pour tous les types de champs du pagineur de données. Les champs du pagineur des données sont utilisés par le contrôle DataPager pour représenter un contrôle de navigation.
Utilisez les classes dérivées de DataPagerField pour sélectionner quel type de pagineur est affiché dans le contrôle DataPager. Le tableau suivant répertorie les types de champ disponibles du pagineur de données.
|
Type de champ du pagineur |
Description |
|---|---|
|
Permet aux utilisateurs de naviguer à travers des pages de données à raison d'une page à la fois, ou d'accéder à la première ou à la dernière page. |
|
|
Permet aux utilisateurs de sélectionner une page par son numéro de page. |
|
|
Permet aux développeurs de pages de créer une interface utilisateur de pagination personnalisée. |
Vous pouvez dériver de la classe DataPagerField pour créer des types de champ de pagineur supplémentaires.
Remarques à l'attention des héritiers
Lorsque vous héritez de la classe DataPagerField, vous devez substituer les membres suivants :
L'exemple suivant montre comment utiliser des objets NextPreviousPagerField, NumericPagerField et TemplatePagerField pour afficher des contrôles de navigation de page dans un contrôle DataPager. Les objets sont dérivés de la classe DataPagerField.
<%@ 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 id="Head1" runat="server"> <title>DataPagerField Example</title> <style type="text/css"> body { text-align: center; font: 13px Tahoma, Arial, Helvetica; } .item { border-bottom: solid 1px #FFA500; font-weight:bold; } </style> </head> <body> <form id="form1" runat="server"> <h3>DataPagerField Example</h3> <asp:ListView ID="ProductsListView" DataSourceID="ContactsDataSource" runat="server"> <LayoutTemplate> <table runat="server" id="tblProducts" width="350"> <tr runat="server" id="itemPlaceholder" /> </table> </LayoutTemplate> <ItemTemplate> <tr runat="server"> <td class="item"> <asp:Label ID="NameLabel" runat="server" Text='<%#Eval("Name") %>' /> </td> </tr> <tr runat="server"> <td> <asp:Label ID="DescriptionLabel" runat="server" Text='<%#Eval("Description")%>' /> </td> </tr> </ItemTemplate> <ItemSeparatorTemplate> <tr runat="server"> <td> </td> </tr> </ItemSeparatorTemplate> </asp:ListView> <br /> <asp:DataPager runat="server" ID="ProductsDataPager" PageSize="5" PagedControlID="ProductsListView"> <Fields> <asp:TemplatePagerField> <PagerTemplate> <b> Page <asp:Label runat="server" ID="CurrentPageLabel" Text="<%# Container.TotalRowCount>0 ? (Container.StartRowIndex / Container.PageSize) + 1 : 0 %>" /> of <asp:Label runat="server" ID="TotalPagesLabel" Text="<%# Math.Ceiling ((double)Container.TotalRowCount / Container.PageSize) %>" /> </b> <br /><br /> </PagerTemplate> </asp:TemplatePagerField> <asp:NextPreviousPagerField ShowFirstPageButton="true" ShowNextPageButton="false" ShowPreviousPageButton="false" /> <asp:NumericPagerField PreviousPageText="<<" NextPageText=">>" ButtonCount="10" /> <asp:NextPreviousPagerField ShowLastPageButton="true" ShowNextPageButton="false" ShowPreviousPageButton="false" /> </Fields> </asp:DataPager> <!-- This example uses Microsoft SQL Server and connects --> <!-- to the AdventureWorks sample database. Use an ASP.NET --> <!-- expression to retrieve the connection string value --> <!-- from the Web.config file. --> <asp:SqlDataSource ID="ContactsDataSource" runat="server" ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>" SelectCommand="SELECT P.Name, PD.Description FROM Production.ProductModel AS PM INNER JOIN Production.Product AS P ON PM.ProductModelID = P.ProductModelID INNER JOIN Production.ProductModelProductDescriptionCulture AS PMPDC ON PM.ProductModelID = PMPDC.ProductModelID INNER JOIN Production.ProductDescription AS PD ON PMPDC.ProductDescriptionID = PD.ProductDescriptionID WHERE (PMPDC.CultureID = 'en')"> </asp:SqlDataSource> </form> </body> </html>
Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.