NumericPagerField Classe
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.
Représente un champ DataPager qui permet aux utilisateurs de sélectionner un numéro page par page.
public ref class NumericPagerField : System::Web::UI::WebControls::DataPagerFieldpublic class NumericPagerField : System.Web.UI.WebControls.DataPagerFieldtype NumericPagerField = class
inherit DataPagerFieldPublic Class NumericPagerField
Inherits DataPagerField- Héritage
Exemples
L’exemple suivant montre comment utiliser un NumericPagerField objet pour parcourir les données affichées dans un ListView 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 id="Head1" runat="server">
<title>NumericPagerField Example</title>
<style type="text/css">
body
{
text-align: center;
font: 12px Arial, Helvetica, sans-serif;
}
table
{
padding: 2px 2px 2px 2px;
border: 1px solid;
width: 500px;
}
.CurrentPage
{
padding: 2px 6px;
border: solid 1px #ddd;
background: #2E8B57;
color:White;
}
.PrevNext,.PageNumber
{
padding: 2px 6px;
border: solid 1px #ddd;
text-decoration: none;
color: #2E8B57;
}
.PageNumber:hover, .PrevNext:hover
{
background-color: #FFA500;
color: White;
}
</style>
</head>
<body>
<form id="form1" runat="server">
<h3>NumericPagerField Example</h3>
<asp:ListView ID="ContactsListView"
DataSourceID="ContactsDataSource"
runat="server">
<LayoutTemplate>
<table runat="server" id="tblContacts">
<tr id="itemPlaceholder" runat="server">
</tr>
</table>
</LayoutTemplate>
<ItemTemplate>
<tr runat="server">
<td>
<asp:Label ID="IDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
</td>
<td align="left">
<asp:Label ID="NameLabel" runat="server"
Text='<%#Eval("LastName") + ", " + Eval("FirstName")%>' />
</td>
</tr>
</ItemTemplate>
</asp:ListView>
<br />
<div>
<asp:DataPager runat="server"
ID="ContactsDataPager"
PagedControlID="ContactsListView">
<Fields>
<asp:NumericPagerField
PreviousPageText="< Prev"
NextPageText="Next >"
ButtonCount="10"
NextPreviousButtonCssClass="PrevNext"
CurrentPageLabelCssClass="CurrentPage"
NumericButtonCssClass="PageNumber" />
</Fields>
</asp:DataPager>
</div>
<br />
<!-- 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 [ContactID], [FirstName], [LastName]
FROM Person.Contact">
</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 id="Head1" runat="server">
<title>NumericPagerField Example</title>
<style type="text/css">
body
{
text-align: center;
font: 12px Arial, Helvetica, sans-serif;
}
table
{
padding: 2px 2px 2px 2px;
border: 1px solid;
width: 500px;
}
.CurrentPage
{
padding: 2px 6px;
border: solid 1px #ddd;
background: #2E8B57;
color:White;
}
.PrevNext,.PageNumber
{
padding: 2px 6px;
border: solid 1px #ddd;
text-decoration: none;
color: #2E8B57;
}
.PageNumber:hover, .PrevNext:hover
{
background-color: #FFA500;
color: White;
}
</style>
</head>
<body>
<form id="form1" runat="server">
<h3>NumericPagerField Example</h3>
<asp:ListView ID="ContactsListView"
DataSourceID="ContactsDataSource"
runat="server">
<LayoutTemplate>
<table runat="server" id="tblContacts">
<tr id="itemPlaceholder" runat="server">
</tr>
</table>
</LayoutTemplate>
<ItemTemplate>
<tr runat="server">
<td>
<asp:Label ID="IDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
</td>
<td align="left">
<asp:Label ID="NameLabel" runat="server"
Text='<%#Eval("LastName") & ", " & Eval("FirstName")%>' />
</td>
</tr>
</ItemTemplate>
</asp:ListView>
<br />
<div>
<asp:DataPager runat="server"
ID="ContactsDataPager"
PagedControlID="ContactsListView">
<Fields>
<asp:NumericPagerField
PreviousPageText="< Prev"
NextPageText="Next >"
ButtonCount="10"
NextPreviousButtonCssClass="PrevNext"
CurrentPageLabelCssClass="CurrentPage"
NumericButtonCssClass="PageNumber" />
</Fields>
</asp:DataPager>
</div>
<br />
<!-- 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 [ContactID], [FirstName], [LastName]
FROM Person.Contact">
</asp:SqlDataSource>
</form>
</body>
</html>
Remarques
La NumericPagerField classe affiche les contrôles de navigation dans un DataPager contrôle. Les contrôles peuvent être utilisés pour parcourir les données affichées par un contrôle qui implémente l’interface IPageableItemContainer , comme le ListView contrôle. L’objet NumericPagerField affiche les numéros de page sous la forme de boutons sur tableaux que les utilisateurs peuvent cliquer pour accéder à une page spécifique. Le contrôle affiche également les boutons page suivante et page précédente qui permettent aux utilisateurs d’accéder à plus de pages de données que celles affichées par le contrôle.
Vous pouvez personnaliser l’apparence de l’objet NumericPagerField à l’aide des propriétés répertoriées dans le tableau suivant.
| Propriété | Description |
|---|---|
| CurrentPageLabelCssClass | Classe CSS pour le numéro de page actuel. |
| NextPreviousButtonCssClass | Classe CSS pour les boutons page suivante et page précédente. |
| NumericButtonCssClass | Classe CSS pour les boutons qui représentent les numéros de page. |
Vous pouvez utiliser la ButtonType propriété pour sélectionner le type de bouton qui sera affiché. Le tableau suivant répertorie les types de boutons disponibles.
| Type de bouton | Description |
|---|---|
| ButtonType.Button | un contrôle Button. |
| ButtonType.Image | Contrôle ImageButton. |
| ButtonType.Link | un contrôle LinkButton. |
Les contrôles à l’intérieur de l’objet NumericButtonCssClass sont rendus avec des espaces sans rupture entre eux. Si vous souhaitez personnaliser ce comportement, vous pouvez utiliser la RenderNonBreakingSpacesBetweenControls propriété .
Vous pouvez masquer un NumericPagerField objet dans un DataPager contrôle en affectant à la propriété la Visible valeur false. Vous ne pouvez pas contrôler la visibilité des boutons page suivante et page précédente. Ils sont affichés par le contrôle si le contrôle de données associé a des pages supplémentaires disponibles pour l’affichage. Vous pouvez utiliser la propriété pour spécifier le ButtonCount nombre de boutons affichés dans un NumericPagerField objet . Chaque bouton correspond à un numéro de page.
Vous pouvez définir le texte du bouton de page suivante en définissant la NextPageText propriété . Vous pouvez définir le texte du bouton de la page précédente à l’aide de la PreviousPageText propriété .
Lorsque la propriété a la ButtonTypeButtonType.Imagevaleur , vous devez fournir l’URL d’une image qui sera affichée pour les boutons de page suivante et de page précédente. Pour ce faire, définissez les NextPageImageUrl propriétés et PreviousPageImageUrl . Dans ce cas, la propriété text correspondante est utilisée comme texte de remplacement pour l’image. Par exemple, le texte spécifié par la NextPageImageUrl propriété s’affiche en tant que texte de remplacement pour le bouton d’image de page suivante. Sur les navigateurs qui prennent en charge les info-bulles, ce texte s’affiche également en tant qu’info-bulle pour le bouton correspondant.
Constructeurs
| NumericPagerField() |
Initialise une nouvelle instance de la classe NumericPagerField. |
Propriétés
| ButtonCount |
Obtient ou définit le nombre de bouton à afficher dans un objet NumericPagerField. |
| ButtonType |
Obtient ou définit le type de bouton à afficher dans le champ du pagineur. |
| CurrentPageLabelCssClass |
Obtient ou définit la classe de feuille de style en cascade (CSS) utilisée pour affecter un style au numéro de page actuelle. |
| DataPager |
Obtient une référence au pagineur de données auquel l'objet DataPagerField est associé. (Hérité de DataPagerField) |
| IsTrackingViewState |
Obtient une valeur qui indique si l'objet DataPagerField suit les modifications apportées à son état d'affichage. (Hérité de DataPagerField) |
| NextPageImageUrl |
Obtient ou définit l'URL d'une image affichée pour le bouton Page suivante dans l'objet NumericPagerField. |
| NextPageText |
Obtient ou définit le texte qui est affiché pour le bouton de page suivante. |
| NextPreviousButtonCssClass |
Obtient ou définit la classe de feuille de style en cascade (CSS) utilisée pour affecter un style aux boutons Page suivante et Page précédente du champ du pagineur. |
| NumericButtonCssClass |
Obtient ou définit la classe de feuille de style en cascade (CSS) utilisée pour affecter un style aux boutons de numéro de page du champ du pagineur. |
| PreviousPageImageUrl |
Obtient ou définit l'URL d'une image affichée pour le bouton Page précédente dans l'objet NumericPagerField. |
| PreviousPageText |
Obtient ou définit le texte qui est affiché pour le bouton de page précédente. |
| QueryStringHandled |
Obtient ou définit une valeur qui indique si le champ de chaîne de requête a été évalué. (Hérité de DataPagerField) |
| QueryStringValue |
Obtient la valeur du champ de chaîne de requête auprès de l'URL de la demande. (Hérité de DataPagerField) |
| RenderNonBreakingSpacesBetweenControls |
Obtient ou définit une valeur qui indique si des espaces insécables seront rendus entre les contrôles. |
| 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. (Hérité de DataPagerField) |
| Visible |
Obtient ou définit une valeur indiquant si un champ du pagineur de données est restitué. (Hérité de DataPagerField) |
Méthodes
| CloneField() |
Crée une copie de l'objet actuel dérivé de DataPagerField. (Hérité de DataPagerField) |
| CopyProperties(DataPagerField) |
Copie les propriétés de l'objet NumericPagerField actuel vers l'objet DataPagerField spécifié. |
| CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32) |
Crée les contrôles d'interface utilisateur pour l'objet de champ du pagineur et les ajoute au conteneur spécifié. |
| CreateField() |
Crée et retourne une instance de la classe NumericPagerField. |
| Equals(Object) |
Détermine si l'objet spécifié est identique à l'objet NumericPagerField actuel. |
| GetHashCode() |
Sert de fonction de hachage pour la classe NumericPagerField. |
| GetQueryStringNavigateUrl(Int32) |
Crée une URL qui contient un champ de chaîne de requête contenant le numéro de page spécifié. (Hérité de DataPagerField) |
| GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
| HandleEvent(CommandEventArgs) |
Gère les événements qui se produisent dans l'objet NumericPagerField et exécute l'action appropriée. |
| LoadViewState(Object) |
Restaure des informations d'état de vue enregistrées précédemment. (Hérité de DataPagerField) |
| MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
| OnFieldChanged() |
Déclenche l’événement |
| SaveViewState() |
Enregistre les modifications apportées à l'état de vue de l'objet DataPagerField. (Hérité de 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. (Hérité de DataPagerField) |
Implémentations d’interfaces explicites
| IStateManager.IsTrackingViewState |
Obtient une valeur qui indique si l'objet DataPagerField suit les modifications apportées à son état d'affichage. (Hérité de DataPagerField) |
| IStateManager.LoadViewState(Object) |
Restaure des informations d'état de vue enregistrées précédemment. (Hérité de DataPagerField) |
| IStateManager.SaveViewState() |
Enregistre les modifications apportées à l'état de vue de l'objet DataPagerField. (Hérité de DataPagerField) |
| IStateManager.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. (Hérité de DataPagerField) |
