Freigeben über

FormView.AllowPaging Eigenschaft

Definition

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

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Paging-Feature aktiviert ist.

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

Eigenschaftswert

Boolean

trueum das Paging-Feature zu aktivieren; andernfalls . false Der Standardwert lautet false.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie die AllowPaging Eigenschaft verwenden, um die Pagingfunktion in einem FormView Steuerelement zu aktivieren.


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

Hinweise

Das FormView Steuerelement verfügt über integrierte Pagingfunktionen, mit denen ein Benutzer zu einem anderen Datensatz in der Datenquelle navigieren kann. Das Paging-Feature kann mit jedem Datenquellenobjekt verwendet werden, das die Schnittstelle oder eine Datenquelle unterstützt, die System.Collections.ICollection die Pagingfunktion unterstützt.

Um das Paging-Feature zu aktivieren, legen Sie die AllowPaging Eigenschaft auf true. Sie können die Gesamtanzahl der Elemente in der zugrunde liegenden Datenquelle mithilfe der PageCount Eigenschaft ermitteln. Verwenden Sie die PageIndex Eigenschaft, um den Index des aktuell angezeigten Elements zu ermitteln.

Wenn das Paging aktiviert ist, wird automatisch eine zusätzliche Zeile mit dem Namen pager row im FormView Steuerelement angezeigt. Die Pagerzeile enthält die Seitennavigationssteuerelemente und kann oben, unten oder oben und unten des Steuerelements angezeigt werden. Die Pagerzeile verfügt über vier integrierte Pageranzeigemodi. In der folgenden Tabelle werden die vier Modi beschrieben.

Modus Beschreibung
PagerButton.NextPrevious Eine Reihe von Paginierungssteuerelementen, die aus vorherigen und nächsten Schaltflächen bestehen.
PagerButton.NextPreviousFirstLast Eine Reihe von Paginierungssteuerelementen, die aus vorherigen, nächsten, ersten und letzten Schaltflächen bestehen.
PagerButton.Numeric Eine Reihe von Paginierungssteuerelementen, die aus nummerierten Linkschaltflächen bestehen, um direkt auf Seiten zuzugreifen. Dies ist der Standardmodus.
PagerButton.NumericFirstLast Eine Reihe von Paginierungssteuerelementen, die aus nummerierten und ersten und letzten Verknüpfungsschaltflächen bestehen.

Hinweis

Das FormView Steuerelement blendet die Pagerzeile automatisch aus, wenn die Datenquelle weniger als zwei Datensätze enthält.

Sie können die Einstellungen der Pagerzeile (z. B. den Seitenanzeigemodus, die Anzahl der seitenlinks, die gleichzeitig angezeigt werden sollen, und die Textbeschriftung des Pager-Steuerelements) mithilfe der PagerSettings Eigenschaft steuern. Verwenden Sie die PagerStyle Eigenschaft, um die Darstellung der Pagerzeile (einschließlich hintergrundfarbe und Schriftfarbe) zu steuern. Mit dem FormView Steuerelement können Sie auch eine benutzerdefinierte Vorlage für die Pagerzeile definieren. Weitere Informationen zum Erstellen einer benutzerdefinierten Pagerzeilenvorlage finden Sie unter PagerTemplate.

Das FormView Steuerelement stellt mehrere Ereignisse bereit, mit denen Sie beim Paging eine benutzerdefinierte Aktion ausführen können. In der folgenden Tabelle sind die verfügbaren Ereignisse aufgeführt.

Ereignis Beschreibung
PageIndexChanged Tritt auf, wenn auf eine der Pagerschaltflächen geklickt wird, aber nachdem das FormView Steuerelement den Auslagerungsvorgang verarbeitet hat. Dieses Ereignis wird häufig verwendet, wenn Sie eine Aufgabe ausführen müssen, nachdem der Benutzer zu einem anderen Datensatz im Steuerelement navigiert hat.
PageIndexChanging Tritt auf, wenn auf eine der Pagerschaltflächen geklickt wird, aber bevor das FormView Steuerelement den Auslagerungsvorgang behandelt. Dieses Ereignis wird häufig verwendet, um den Auslagerungsvorgang abzubrechen.

Hinweis

Diese Ereignisse werden nicht ausgelöst, wenn Sie die PageIndex Eigenschaft programmgesteuert ändern.

Gilt für:

Weitere Informationen