NumericPagerField Classe

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.Extensions.dll

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::DataPagerField

public class NumericPagerField : System.Web.UI.WebControls.DataPagerField

type NumericPagerField = class
    inherit DataPagerField

Public Class NumericPagerField
Inherits DataPagerField

Héritage: Object

DataPagerField
NumericPagerField

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 de page suivante et de 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 ButtonType ButtonType.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 sous forme d’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 `FieldChanged`. (Hérité de DataPagerField)
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)

S’applique à