FormView.AllowPaging Eigenschaft

  • Referenz

Definition

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

Ruft einen Wert ab, der angibt, ob das Pagingfeature aktiviert ist, oder legt diesen fest.

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

true, um das Pagingfeature zu aktivieren, andernfalls false. Der Standardwert ist false.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die AllowPaging -Eigenschaft verwendet wird, 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 Pagingfeature kann mit jedem Datenquellenobjekt verwendet werden, das die System.Collections.ICollection Schnittstelle unterstützt, oder mit einer Datenquelle, die Pagingfunktionen unterstützt.

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

Wenn das Paging aktiviert ist, wird automatisch eine zusätzliche Zeile mit dem Namen Pagerzeile 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.

Mode BESCHREIBUNG
PagerButton.NextPrevious Ein Satz von Paginierungssteuerelementen, die aus vorherigen und nächsten Schaltflächen bestehen.
PagerButton.NextPreviousFirstLast Ein Satz von Paginierungssteuerelementen, die aus vorherigen, weiter, ersten und letzten Schaltflächen bestehen.
PagerButton.Numeric Eine aus nummerierten Linkschaltflächen für den direkten Zugriff auf Seiten bestehende Gruppe von Paginierungssteuerelementen. Dies ist der Standardmodus.
PagerButton.NumericFirstLast Ein Satz von Paginierungssteuerelementen, die aus nummerierten Schaltflächen und Schaltflächen für den ersten und letzten Link 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 Anzeigemodus des Pagers, die Anzahl der gleichzeitig anzuzeigenden Seitenlinks und die Textbeschriftung des Pagersteuerelements) mithilfe der PagerSettings -Eigenschaft steuern. Verwenden PagerStyle Sie die -Eigenschaft, um die Darstellung der Pagerzeile (einschließlich der Hintergrund- und Schriftfarbe) zu steuern. Mit FormView dem -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, die Sie verwenden können, um eine benutzerdefinierte Aktion auszuführen, wenn paging erfolgt. In der folgenden Tabelle sind die verfügbaren Ereignisse aufgeführt.

Ereignis BESCHREIBUNG
PageIndexChanged Tritt ein, wenn auf eine der Pagerschaltflächen geklickt wird, allerdings nachdem das FormView-Steuerelement den Pagingvorgang behandelt 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 ein, wenn auf eine der Pagerschaltflächen geklickt wird, allerdings bevor das FormView-Steuerelement den Pagingvorgang 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