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 DataPager champ qui permet aux utilisateurs de sélectionner une page par numéro de 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 des 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 des 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 forme de boutons 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 actif. |
| 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 s’affiche. Le tableau suivant répertorie les types de boutons disponibles.
| Type de bouton | Description |
|---|---|
| ButtonType.Button | Contrôle Button . |
| ButtonType.Image | Contrôle ImageButton . |
| ButtonType.Link | Contrôle LinkButton . |
Les contrôles à l’intérieur de l’objet NumericButtonCssClass sont rendus avec des espaces non cassants 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 définissant la Visible propriété sur false. Vous ne pouvez pas contrôler la visibilité des boutons de page suivante et de page précédente. Elles sont affichées par le contrôle si le contrôle de données associé dispose de pages supplémentaires disponibles pour l’affichage. Vous pouvez utiliser la ButtonCount propriété pour spécifier le 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 page précédente à l’aide de la PreviousPageText propriété.
Lorsque la ButtonType propriété est définie ButtonType.Imagesur , vous devez fournir l’URL d’une image qui s’affiche pour les boutons de page suivante et de page précédente. Pour ce faire, définissez les propriétés et PreviousPageImageUrl les NextPageImageUrl propriétés. Dans ce cas, la propriété de texte 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 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
| Nom | Description |
|---|---|
| NumericPagerField() |
Initialise une nouvelle instance de la classe NumericPagerField. |
Propriétés
| Nom | Description |
|---|---|
| ButtonCount |
Obtient ou définit le nombre de boutons à afficher dans un NumericPagerField objet. |
| ButtonType |
Obtient ou définit le type de bouton à afficher dans le champ du pagineur. |
| CurrentPageLabelCssClass |
Obtient ou définit la classe feuille de style en cascade (CSS) utilisée pour mettre en forme le numéro de page actif. |
| 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 ses modifications d’é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 affiché pour le bouton de page suivante. |
| NextPreviousButtonCssClass |
Obtient ou définit la classe feuille de style en cascade (CSS) utilisée pour mettre en forme les boutons page suivante et page précédente du champ du pagineur. |
| NumericButtonCssClass |
Obtient ou définit la classe feuille de style en cascade (CSS) utilisée pour mettre en forme les boutons de numéro de page du champ 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 affiché pour le bouton 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 à partir de l’URL de la requête. (Hérité de DataPagerField) |
| RenderNonBreakingSpacesBetweenControls |
Obtient ou définit une valeur qui indique si les espaces non cassants sont 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 DataPagerField objet sur plusieurs requêtes pour la même page. (Hérité de DataPagerField) |
| Visible |
Obtient ou définit une valeur qui indique si un champ de pagineur de données est affiché. (Hérité de DataPagerField) |
Méthodes
| Nom | Description |
|---|---|
| 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 actif NumericPagerField vers l’objet spécifié DataPagerField . |
| 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 nouvelle instance de la NumericPagerField classe. |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel NumericPagerField . |
| GetHashCode() |
Sert de fonction de hachage pour la NumericPagerField classe. |
| GetQueryStringNavigateUrl(Int32) |
Crée une URL qui contient un champ de chaîne de requête qui a le numéro de page spécifié. (Hérité de DataPagerField) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| HandleEvent(CommandEventArgs) |
Gère les événements qui se produisent dans l’objet NumericPagerField et effectue l’action appropriée. |
| LoadViewState(Object) |
Restaure les informations d’état d’affichage qui ont été enregistrées précédemment. (Hérité de DataPagerField) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| OnFieldChanged() |
Déclenche l’événement |
| SaveViewState() |
Enregistre les modifications apportées à l’état d’affichage de l’objet DataPagerField . (Hérité de DataPagerField) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
| TrackViewState() |
Provoque le DataPagerField suivi des modifications apportées à son état d’affichage afin qu’ils puissent être stockés dans la propriété du ViewState contrôle et conservés dans les requêtes pour la même page. (Hérité de DataPagerField) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IStateManager.IsTrackingViewState |
Obtient une valeur qui indique si l’objet DataPagerField suit ses modifications d’état d’affichage. (Hérité de DataPagerField) |
| IStateManager.LoadViewState(Object) |
Restaure les informations d’état d’affichage qui ont été enregistrées précédemment. (Hérité de DataPagerField) |
| IStateManager.SaveViewState() |
Enregistre les modifications apportées à l’état d’affichage de l’objet DataPagerField . (Hérité de DataPagerField) |
| IStateManager.TrackViewState() |
Provoque le DataPagerField suivi des modifications apportées à son état d’affichage afin qu’ils puissent être stockés dans la propriété du ViewState contrôle et conservés dans les requêtes pour la même page. (Hérité de DataPagerField) |
