FormView.AllowPaging Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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:

Freigeben über