FormView.AllowPaging Eigenschap

Definitie

Naamruimte:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de wisselfunctie is ingeschakeld.

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

Waarde van eigenschap

Boolean

true om de wisselfunctie in te schakelen; anders, false. De standaardwaarde is false.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de AllowPaging eigenschap gebruikt om de pagingfunctie in een FormView besturingselement in te schakelen.


<%@ 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>

Opmerkingen

Het FormView besturingselement heeft ingebouwde pagineringsmogelijkheden, waarmee een gebruiker naar een andere record in de gegevensbron kan navigeren. De wisselfunctie kan worden gebruikt met elk gegevensbronobject dat ondersteuning biedt voor de System.Collections.ICollection interface of een gegevensbron die ondersteuning biedt voor pagingmogelijkheden.

Als u de wisselfunctie wilt inschakelen, stelt u de AllowPaging eigenschap in op true. U kunt het totale aantal items in de onderliggende gegevensbron bepalen met behulp van de PageCount eigenschap. Gebruik de PageIndex eigenschap om de index van het momenteel weergegeven item te bepalen.

Wanneer pagineering is ingeschakeld, wordt automatisch een extra rij met de naam van de pagerrij weergegeven in het FormView besturingselement. De paginarij bevat de besturingselementen voor paginanavigatie en kan worden weergegeven aan de boven-, onder- of onderkant van het besturingselement. De pagerrij heeft vier ingebouwde pagerweergavemodi. In de volgende tabel worden de vier modi beschreven.

Mode Beschrijving
PagerButton.NextPrevious Een set pagineringsbesturingselementen die bestaan uit vorige en volgende knoppen.
PagerButton.NextPreviousFirstLast Een set pagineringsbesturingselementen die bestaan uit vorige, volgende, eerste en laatste knoppen.
PagerButton.Numeric Een set pagineringsbesturingselementen die bestaan uit genummerde koppelingsknoppen om rechtstreeks toegang te krijgen tot pagina's. Dit is de standaardmodus.
PagerButton.NumericFirstLast Een set pagineringsbesturingselementen die bestaan uit genummerde en eerste en laatste koppelingsknoppen.

Note

Het FormView besturingselement verbergt automatisch de pagerrij wanneer de gegevensbron minder dan twee records bevat.

U kunt de instellingen van de paginarij (zoals de weergavemodus van de pager, het aantal paginakoppelingen dat tegelijk moet worden weergegeven en het tekstlabel van het pagerbesturingselement) beheren met behulp van de PagerSettings eigenschap. Gebruik de PagerStyle eigenschap om het uiterlijk van de pagerrij te bepalen (inclusief de achtergrondkleur en tekstkleur). FormView Met het besturingselement kunt u ook een aangepaste sjabloon definiëren voor de paginarij. Zie voor meer informatie over het maken van een aangepaste pagerrijsjabloon PagerTemplate.

Het FormView besturingselement biedt verschillende gebeurtenissen die u kunt gebruiken om een aangepaste actie uit te voeren wanneer paging plaatsvindt. De volgende tabel bevat de beschikbare gebeurtenissen.

Gebeurtenis Beschrijving
PageIndexChanged Treedt op wanneer op een van de paginaknoppen wordt geklikt, maar nadat het FormView besturingselement de wisselbewerking heeft verwerkt. Deze gebeurtenis wordt vaak gebruikt wanneer u een taak moet uitvoeren nadat de gebruiker naar een andere record in het besturingselement navigeert.
PageIndexChanging Treedt op wanneer op een van de paginaknoppen wordt geklikt, maar voordat het FormView besturingselement de wisselbewerking afhandelt. Deze gebeurtenis wordt vaak gebruikt om het pagina-bewerkingsproces te annuleren.

Note

Deze gebeurtenissen worden niet gegenereerd wanneer u de PageIndex eigenschap programmatisch wijzigt.

Van toepassing op

Zie ook