Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.

Traduction

Source

Ce sujet n'a pas encore été évalué - Évaluez ce sujet

FormView.TopPagerRow, propriété

.NET Framework 4.5

Autres versions

Obtient l'objet FormViewRow qui représente la ligne de pagineur affichée en haut d'un contrôle FormView.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans System.Web.dll)

Syntaxe

C++

[BrowsableAttribute(false)]
public virtual FormViewRow TopPagerRow { get; }

Valeur de propriété

Type : System.Web.UI.WebControls.FormViewRow
FormViewRow qui représente la ligne du haut du pagineur dans le contrôle FormView.

Notes

Lorsque la pagination est activée (lorsque true est affecté à la propriété AllowPaging), une ligne supplémentaire appelée ligne de pagineur est automatiquement affichée dans le contrôle FormView. La ligne de pagineur contient des contrôles permettant à l'utilisateur de naviguer vers d'autres enregistrements et peut être affichée en haut, en bas ou en haut et en bas du contrôle. Utilisez la propriété TopPagerRow pour accéder par programme à l'objet FormViewRow qui représente la ligne du haut du pagineur dans un contrôle FormView.

Remarque
La propriété TopPagerRow est disponible uniquement après que le contrôle FormView a créé la ligne du haut du pagineur dans l'événement ItemCreated.

Cette propriété est couramment utilisée lorsque vous devez manipuler par programme la ligne du haut du pagineur, par exemple lors de l'ajout de contenu personnalisé. Toute modification apportée à la propriété TopPagerRow doit être effectuée après que le contrôle FormView a été lié aux données ; sinon, le contrôle FormView remplace toutes les modifications.

Exemples

L'exemple suivant montre comment utiliser la propriété TopPagerRow pour accéder à la ligne de pagineur affichée en haut d'un contrôle FormView. La ligne de pagineur est alors mise à jour avec le contenu supplémentaire.



<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void EmployeeFormView_ItemCreated(Object sender, EventArgs e)
  {

    // Get the pager row.
    FormViewRow pagerRow = EmployeeFormView.TopPagerRow;

    // Get the Label controls that display the current page information 
    // from the pager row.
    Label pageNum = (Label)pagerRow.FindControl("PageNumberLabel");
    Label totalNum = (Label)pagerRow.FindControl("TotalPagesLabel");

    if ((pageNum != null) && (totalNum != null))
    {
      // Update the Label controls with the current page values.
      int page = EmployeeFormView.PageIndex + 1;
      int count = EmployeeFormView.PageCount;

      pageNum.Text = page.ToString();
      totalNum.Text = count.ToString();
    }

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>FormView PagerTemplate Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>FormView PagerTemplate Example</h3>

      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID"
        onitemcreated="EmployeeFormView_ItemCreated" 
        runat="server">

        <itemtemplate>
          <table>
            <tr>
              <td>
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td>
                <h3><%# Eval("FirstName") %>&nbsp;<%# Eval("LastName") %></h3>      
                <%# Eval("Title") %>        
              </td>
            </tr>
          </table>    
        </itemtemplate>

        <pagertemplate>   
          <table width="100%">
            <tr>
              <td>
                <asp:linkbutton id="PreviousButton"
                  text="<"
                  commandname="Prev"
                  runat="Server"/>
                <asp:linkbutton id="NextButton"
                  text=">"
                  commandName="Next"
                  runat="Server"/> 
              </td>
              <td align="right">                
                Page <asp:label id="PageNumberLabel" runat="server"/> 
                of <asp:label id="TotalPagesLabel" runat="server"/>                
              </td>
            </tr>
          </table>          
        </pagertemplate>

        <pagersettings position="Top"
          mode="NextPrevious"/> 

      </asp:formview>

      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="EmployeeSource"
        selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>

    </form>
  </body>
</html>

Informations de version

.NET Framework

Pris en charge dans : 4.5, 4, 3.5, 3.0, 2.0

Plateformes

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Voir aussi