NextPreviousPagerField 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 qui affiche des contrôles de navigation dans un contrôle DataPager pour permettre aux utilisateurs de parcourir les données.

public ref class NextPreviousPagerField : System::Web::UI::WebControls::DataPagerField

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

type NextPreviousPagerField = class
    inherit DataPagerField

Public Class NextPreviousPagerField
Inherits DataPagerField

Héritage: Object

DataPagerField
NextPreviousPagerField

Exemples

L’exemple suivant montre comment utiliser un NextPreviousPagerField objet pour pager 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>NextPreviousPagerField Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NextPreviousPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="ContactIDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td>
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <asp:DataPager runat="server" ID="ContactsDataPager" PagedControlID="ContactsListView">
        <Fields>
          <asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true" />
        </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 [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>NextPreviousPagerField Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NextPreviousPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="ContactIDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td>
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <asp:DataPager runat="server" ID="ContactsDataPager" PagedControlID="ContactsListView">
        <Fields>
          <asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true" />
        </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 [ContactID], [FirstName], [LastName] FROM Person.Contact">
      </asp:SqlDataSource>
      
    </form>
  </body>
</html>

Remarques

La NextPreviousPagerField classe représente un champ qui affiche les contrôles de navigation dans un DataPager contrôle. Ces contrôles de navigation peuvent être utilisés pour pager des données affichées par un contrôle qui implémente l’interface IPageableItemContainer , comme le ListView contrôle.

La NextPreviousPagerField classe fournit des boutons qui permettent aux utilisateurs de parcourir les pages de données d’une page à la fois ou de passer à la première ou dernière page de données.

Vous pouvez personnaliser l’apparence de l’objet NextPreviousPagerField à l’aide de la ButtonCssClass propriété pour définir le style des boutons. Vous pouvez également utiliser la ButtonType propriété pour choisir le type de bouton affiché. Le tableau suivant répertorie les types de boutons disponibles.

Type de bouton	Description
Button	un contrôle Button.
Image	Contrôle ImageButton.
Link	un contrôle LinkButton.

Vous pouvez masquer un NextPreviousPagerField objet dans un DataPager contrôle en définissant la Visible propriété sur false. Vous pouvez également masquer les boutons individuels (la première page, la page précédente, la page suivante et les boutons de dernière page) en définissant les ShowFirstPageButtonboutons , et ShowLastPageButton ShowPreviousPageButton ShowNextPageButtonles propriétés falsesur .

Le NextPreviousPagerField contrôle vous permet de spécifier du texte personnalisé pour chaque bouton à l’aide des propriétés, PreviousPageText NextPageTextet LastPageText des FirstPageTextpropriétés.

Lorsque la ButtonType propriété est définie ButtonType.Imagesur , vous devez fournir l’URL à une image qui sera affichée pour le bouton. Vous pouvez définir des images individuellement pour chaque bouton en définissant les propriétés et PreviousPageImageUrl NextPageImageUrl LastPageImageUrl les FirstPageImageUrlpropriétés.

Lorsque la ButtonType propriété est définie sur ButtonType.Image, la propriété de texte correspondante agit comme texte alternatif pour l’image. Par exemple, le texte spécifié par la FirstPageText propriété s’affiche en tant que texte alternatif pour le bouton d’image de première page. Dans les navigateurs qui prennent en charge les info-bulles, ce texte s’affiche également en tant qu’info-bulle.

Constructeurs

NextPreviousPagerField()

Initialise une nouvelle instance de la classe NextPreviousPagerField.

Propriétés

ButtonCssClass	Obtient ou définit la classe de feuille de style en cascade (CSS) utilisée pour le rendu des boutons du champ du pagineur dans le navigateur.
ButtonType	Obtient ou définit le type de bouton à afficher dans le champ du pagineur.
DataPager	Obtient une référence au pagineur de données auquel l'objet DataPagerField est associé. (Hérité de DataPagerField)
FirstPageImageUrl	Obtient ou définit l'URL d'une image affichée pour le bouton de première page.
FirstPageText	Obtient ou définit le texte qui est affiché pour le bouton de première page.
IsTrackingViewState	Obtient une valeur qui indique si l'objet DataPagerField suit les modifications apportées à son état d'affichage. (Hérité de DataPagerField)
LastPageImageUrl	Obtient ou définit l'URL d'une image affichée pour le bouton de dernière page dans l'objet NextPreviousPagerField.
LastPageText	Obtient ou définit le texte qui est affiché pour le bouton de dernière page.
NextPageImageUrl	Obtient ou définit l'URL d'une image affichée pour le bouton de page suivante dans l'objet NextPreviousPagerField.
NextPageText	Obtient ou définit le texte qui est affiché pour le bouton de page suivante.
PreviousPageImageUrl	Obtient ou définit l'URL d'une image affichée pour le bouton de page précédente dans l'objet NextPreviousPagerField.
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)
RenderDisabledButtonsAsLabels	Obtient ou définit une valeur qui indique si les boutons désactivés sont rendus en tant que contrôles Label par l'objet NextPreviousPagerField.
RenderNonBreakingSpacesBetweenControls	Obtient ou définit une valeur qui indique si les espaces insécables sont rendus entre les contrôles.
ShowFirstPageButton	Obtient ou définit une valeur qui indique si le bouton de première page est affiché dans un objet NextPreviousPagerField.
ShowLastPageButton	Obtient ou définit une valeur qui indique si le bouton de dernière page est affiché dans un objet NextPreviousPagerField.
ShowNextPageButton	Obtient ou définit une valeur qui indique si le bouton de page suivante est affiché dans un objet NextPreviousPagerField.
ShowPreviousPageButton	Obtient ou définit une valeur qui indique si le bouton de page précédente est affiché dans un objet NextPreviousPagerField.
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 NextPreviousPagerField 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 NextPreviousPagerField.
Equals(Object)	Détermine si l'objet spécifié est identique à l'objet NextPreviousPagerField actuel.
GetHashCode()	Sert de fonction de hachage pour la classe NextPreviousPagerField.
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 le contrôle NextPreviousPagerField 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 à