FormView.AllowPaging Propriété

  • Référence

Définition

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

Obtient ou définit une valeur indiquant si la fonctionnalité de pagination est activée.

public:
 virtual property bool AllowPaging { bool get(); void set(bool value); };
public virtual bool AllowPaging { get; set; }
member this.AllowPaging : bool with get, set
Public Overridable Property AllowPaging As Boolean

Valeur de propriété

Boolean

true pour activer la fonctionnalité de pagination ; sinon, false. La valeur par défaut est false.

Exemples

L’exemple suivant montre comment utiliser la AllowPaging propriété pour activer la fonctionnalité de pagination dans un FormView 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 runat="server">
    <title>FormView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>FormView AllowPaging Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID" 
        runat="server">
        
        <pagersettings mode="Numeric"
          position="Bottom"/>
          
        <pagerstyle backcolor="LightBlue"
          horizontalalign="Center"/>
        
        <itemtemplate>
        
          <table>
            <tr>
              <td>
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td>
                <h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3>      
                <%# Eval("Title") %>        
              </td>
            </tr>
          </table>
        
        </itemtemplate> 
                  
      </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>


<%@ 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 runat="server">
    <title>FormView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>FormView AllowPaging Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID" 
        runat="server">
        
        <pagersettings mode="Numeric"
          position="Bottom"/>
          
        <pagerstyle backcolor="LightBlue"
          horizontalalign="Center"/>
        
        <itemtemplate>
        
          <table>
            <tr>
              <td>
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td>
                <h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3>      
                <%# Eval("Title") %>        
              </td>
            </tr>
          </table>
        
        </itemtemplate> 
                  
      </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>

Remarques

Le FormView contrôle dispose de fonctionnalités de pagination intégrées, qui permettent à un utilisateur de naviguer vers un autre enregistrement dans la source de données. La fonctionnalité de pagination peut être utilisée avec n’importe quel objet de source de données prenant en charge l’interface System.Collections.ICollection ou une source de données prenant en charge la fonctionnalité de pagination.

Pour activer la fonctionnalité de pagination, définissez la propriété sur AllowPagingtrue. Vous pouvez déterminer le nombre total d’éléments dans la source de données sous-jacente à l’aide de la PageCount propriété . Pour déterminer l’index de l’élément actuellement affiché, utilisez la PageIndex propriété .

Lorsque la pagination est activée, une ligne supplémentaire appelée ligne du pagineur s’affiche automatiquement dans le FormView contrôle. La ligne du pagineur contient les contrôles de navigation de page et peut être affichée en haut, en bas ou en haut et en bas du contrôle. La ligne du pagineur a quatre modes d’affichage intégrés du pagineur. Le tableau suivant décrit les quatre modes.

Mode Description
PagerButton.NextPrevious Ensemble de contrôles de pagination composé des boutons précédent et suivant.
PagerButton.NextPreviousFirstLast Ensemble de contrôles de pagination composé des boutons précédent, suivant, premier et dernier.
PagerButton.Numeric Ensemble de contrôles de pagination comprenant des boutons de lien numéroté permettant d'accéder directement aux pages. Il s’agit du mode par défaut ;
PagerButton.NumericFirstLast Ensemble de contrôles de pagination composé de boutons numérotés et de premier et dernier lien.

Notes

Le FormView contrôle masque automatiquement la ligne du pagineur lorsque la source de données contient moins de deux enregistrements.

Vous pouvez contrôler les paramètres de la ligne du pagineur (par exemple, le mode d’affichage du pagineur, le nombre de liens de page à afficher à la fois et l’étiquette de texte du contrôle de pager) à l’aide de la PagerSettings propriété . Pour contrôler l’apparence de la ligne du pagineur (y compris sa couleur d’arrière-plan et sa couleur de police), utilisez la PagerStyle propriété . Le FormView contrôle vous permet également de définir un modèle personnalisé pour la ligne du pagineur. Pour plus d’informations sur la création d’un modèle de ligne de paginateur personnalisé, consultez PagerTemplate.

Le FormView contrôle fournit plusieurs événements que vous pouvez utiliser pour effectuer une action personnalisée lors de la pagination. Le tableau suivant répertorie les événements disponibles.

Événement Description
PageIndexChanged Se produit lorsqu'un clic est effectué sur un des boutons de pagineur, mais une fois que le contrôle FormView a géré l'opération de pagination. Cet événement est couramment utilisé lorsque vous devez effectuer une tâche après que l’utilisateur accède à un autre enregistrement dans le contrôle.
PageIndexChanging Se produit lorsqu'un clic est effectué sur des boutons du pagineur et avant que le contrôle FormView n'ait géré l'opération de pagination. Cet événement est souvent utilisé pour annuler l’opération de pagination.

Notes

Ces événements ne sont pas déclenchés lorsque vous modifiez la PageIndex propriété par programmation.

S’applique à

Voir aussi