Partager via


NextPreviousPagerField Classe

Définition

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
NextPreviousPagerField

Exemples

L’exemple suivant montre comment utiliser un NextPreviousPagerField objet pour pager 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>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 parcourir 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 une page à la fois, ou de passer à la première ou à la dernière page de données.

Vous pouvez personnaliser l’apparence de l’objet à l’aide NextPreviousPagerField 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 (les boutons première page, page précédente, page suivante et dernière page) en définissant les ShowFirstPageButtonpropriétés , ShowPreviousPageButton, ShowNextPageButtonet ShowLastPageButton sur false.

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

Lorsque la propriété a la ButtonTypeButtonType.Imagevaleur , vous devez fournir l’URL d’une image qui sera affichée pour le bouton. Vous pouvez définir des images individuellement pour chaque bouton en définissant les FirstPageImageUrlpropriétés , PreviousPageImageUrl, NextPageImageUrlet LastPageImageUrl .

Lorsque la propriété a la ButtonTypeButtonType.Imagevaleur , la propriété de texte correspondante fait office de texte de remplacement pour l’image. Par exemple, le texte spécifié par la FirstPageText propriété s’affiche en tant que texte de remplacement pour le bouton image de première page. Dans les navigateurs qui prennent en charge les info-bulles, ce texte s’affiche également sous forme d’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 à

Voir aussi