FormView.AllowPaging Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar eller anger ett värde som anger om växlingsfunktionen är aktiverad.

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

Egenskapsvärde

Boolean

trueför att aktivera växlingsfunktionen. annars . false Standardvärdet är false.

Exempel

I följande exempel visas hur du använder AllowPaging egenskapen för att aktivera växlingsfunktionen i en FormView kontroll.


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

Kommentarer

Kontrollen FormView har inbyggda växlingsfunktioner som gör att en användare kan navigera till en annan post i datakällan. Växlingsfunktionen kan användas med alla datakällans objekt som stöder System.Collections.ICollection gränssnittet eller en datakälla som stöder växlingsfunktionen.

Om du vill aktivera växlingsfunktionen anger du AllowPaging egenskapen till true. Du kan fastställa det totala antalet objekt i den underliggande datakällan med hjälp PageCount av egenskapen . Om du vill fastställa indexet för det objekt som visas använder du egenskapen PageIndex .

När växling är aktiverat visas en ytterligare rad med namnet pager-raden automatiskt i FormView kontrollen. Pager-raden innehåller sidnavigeringskontrollerna och kan visas överst, längst ned eller både överst och längst ned i kontrollen. Pager-raden har fyra inbyggda sidvisningslägen. I följande tabell beskrivs de fyra lägena.

Mode Description
PagerButton.NextPrevious En uppsättning sidnumreringskontroller som består av föregående och nästa knappar.
PagerButton.NextPreviousFirstLast En uppsättning sidnumreringskontroller som består av föregående, nästa, första och sista knappar.
PagerButton.Numeric En uppsättning sidnumreringskontroller som består av numrerade länkknappar för att komma åt sidor direkt. Det här är standardläget.
PagerButton.NumericFirstLast En uppsättning sidnumreringskontroller som består av numrerade och första och sista länkknappar.

Note

Kontrollen FormView döljer automatiskt pager-raden när datakällan innehåller färre än två poster.

Du kan styra inställningarna för sidsidesraden (till exempel sidvisningsläget, antalet sidlänkar som ska visas i taget och sidkontrollens textetikett) med hjälp PagerSettings av egenskapen . Om du vill styra utseendet på sidsökarraden (inklusive dess bakgrundsfärg och teckenfärg) använder du PagerStyle egenskapen . Med FormView kontrollen kan du också definiera en anpassad mall för pager-raden. Mer information om hur du skapar en anpassad sidradsmall finns i PagerTemplate.

Kontrollen FormView innehåller flera händelser som du kan använda för att utföra en anpassad åtgärd vid växling. I följande tabell visas tillgängliga händelser.

Händelse Description
PageIndexChanged Inträffar när en av sidsidesknapparna klickas, men när FormView kontrollen har hanterat växlingsåtgärden. Den här händelsen används ofta när du behöver utföra en uppgift när användaren har navigerat till en annan post i kontrollen.
PageIndexChanging Inträffar när en av sidsidesknapparna klickas, men innan FormView kontrollen hanterar växlingsåtgärden. Den här händelsen används ofta för att avbryta växlingsåtgärden.

Note

Dessa händelser genereras inte när du ändrar PageIndex egenskapen programmatiskt.

Gäller för

Se även