DetailsView.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 Codebeispiel wird veranschaulicht, wie die AllowPaging -Eigenschaft verwendet wird, um die Pagingfunktionen des DetailsView Steuerelements 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>DetailsView AllowPaging Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AllowPaging Example</h3>
                
        <asp:detailsview id="StoresDetailView"
          datasourceid="Customers"
          autogeneraterows="true" 
          allowpaging="true"
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
            
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"/>
            
          <pagerstyle forecolor="White"
            backcolor="Blue"
            font-names="Arial"
            font-size="8" />   
        </asp:detailsview>
            
        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database. -->           
        <asp:SqlDataSource ID="Customers" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthwindConnectionString %>"
          SelectCommand="SELECT [CompanyName], [ContactName], 
             [CustomerID] FROM [Customers]">
        </asp:SqlDataSource>
            
      </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>DetailsView AllowPaging Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AllowPaging Example</h3>
                
        <asp:detailsview id="StoresDetailView"
          datasourceid="Customers"
          autogeneraterows="true" 
          allowpaging="true"
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
            
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"/>
            
          <pagerstyle forecolor="White"
            backcolor="Blue"
            font-names="Arial"
            font-size="8" />   
        </asp:detailsview>
            
        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database. -->           
        <asp:SqlDataSource ID="Customers" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthwindConnectionString %>"
          SelectCommand="SELECT [CompanyName], [ContactName], 
             [CustomerID] FROM [Customers]">
        </asp:SqlDataSource>
            
      </form>
  </body>
</html>

Hinweise

Das DetailsView Steuerelement verfügt über integrierte Pagingfunktionen, die es einem Benutzer ermöglichen, zu einem anderen Datensatz in der Datenquelle zu navigieren.

Das DetailsView Steuerelement kann sowohl die Benutzeroberfläche (UI) als auch das Paging der Datenquelle ausführen. Das Feature "UI-Paging" kann mit jedem Datenquellenobjekt verwendet werden, das die System.Collections.ICollection Schnittstelle unterstützt. Für jeden Auslagerungsvorgang fragt das DetailsView Steuerelement die Datenquelle für die gesamte Datensammlung ab und wählt die anzuzeigende Zeile aus, wobei im Wesentlichen die verbleibenden Daten verworfen werden.

Wenn eine Datenquelle implementiert DataSourceView ist und die CanPage -Eigenschaft zurückgibt true, verwendet das DetailsView Steuerelement das Paging der Datenquelle anstelle von UI-Paging. In diesem Fall fragt das DetailsView Steuerelement nur die Zeile ab, die für jeden Pagingvorgang erforderlich ist. Daher ist das Paging von Datenquellen effizienter als das Paging der Benutzeroberfläche. Nur das ObjectDataSourceView -Objekt unterstützt das Paging der Datenquelle ohne Änderung.

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

Wenn das Paging aktiviert ist, wird automatisch eine zusätzliche Zeile namens Pagerzeile im DetailsView Steuerelement angezeigt. Die Pagerzeile enthält die Steuerelemente für die Seitennavigation und kann oben, unten oder sowohl oben als auch unten im Steuerelement angezeigt werden. Die Pagerzeile verfügt über zwei integrierte Pageranzeigemodi: nummerierte Seiten und Links für die nächste und vorherige Seite (Standardeinstellung). Im Modus für nummerierte Seiten werden Links für die einzelnen Seiten angezeigt, sodass der Benutzer zu einer bestimmten Seite navigieren kann. Im Modus für die nächste und vorherige Verknüpfung werden Steuerelemente angezeigt, die es dem Benutzer ermöglichen, zur nächsten oder vorherigen Seite zu navigieren.

Hinweis

Das DetailsView 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 Pageranzeigemodus, 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 Hintergrundfarbe, Schriftfarbe und Position) zu steuern. Mit DetailsView 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 DetailsView 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 ein, wenn auf eine der Pagerschaltflächen geklickt wird, allerdings nachdem das DetailsView-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 DetailsView-Steuerelement den Pagingvorgang behandelt. Dieses Ereignis wird häufig verwendet, um den Pagingvorgang abzubrechen.

Der Wert von AllowPaging wird im Ansichtszustand gespeichert.

Gilt für:

Weitere Informationen