Freigeben über

GridView.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

truewenn das Paging-Feature aktiviert ist; andernfalls . false Der Standardwert lautet false.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die AllowPaging Eigenschaft zum deklarativen Aktivieren der Pagingfunktion im GridView Steuerelement verwendet wird.


<%@ 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>GridView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView AllowPaging Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">
                
        <pagersettings mode="Numeric"
          position="Bottom"           
          pagebuttoncount="10"/>
                      
        <pagerstyle backcolor="LightBlue"
          height="30px"
          verticalalign="Bottom"
          horizontalalign="Center"/>
                
      </asp:gridview>
            
      <!-- 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="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        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>GridView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView AllowPaging Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">
                
        <pagersettings mode="Numeric"
          position="Bottom"           
          pagebuttoncount="10"/>
                      
        <pagerstyle backcolor="LightBlue"
          height="30px"
          verticalalign="Bottom"
          horizontalalign="Center"/>
                
      </asp:gridview>
            
      <!-- 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="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
        
    </form>
  </body>
</html>

Hinweise

Anstatt alle Datensätze in der Datenquelle gleichzeitig anzuzeigen, kann das GridView Steuerelement die Datensätze automatisch auf Seiten aufteilen. Wenn die Datenquelle die Pagingfunktion unterstützt, kann das GridView Steuerelement dies nutzen und integrierte Pagingfunktionen bereitstellen. 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. Standardmäßig zeigt das GridView Steuerelement jeweils 10 Datensätze auf einer Seite an. Sie können die Anzahl der auf einer Seite angezeigten Datensätze ändern, indem Sie die PageSize Eigenschaft festlegen. Verwenden Sie PageCount die Eigenschaft, um die Gesamtanzahl der Seiten zu ermitteln, die zum Anzeigen der Datenquelleninhalte erforderlich sind. Sie können den Index der aktuell angezeigten Seite mithilfe der PageIndex Eigenschaft ermitteln.

Wenn das Paging aktiviert ist, wird automatisch eine zusätzliche Zeile mit dem Namen pager row im GridView Steuerelement angezeigt. Die Pagerzeile enthält Steuerelemente, mit denen der Benutzer zu den anderen Seiten navigieren kann. Sie können die Einstellungen der Pagerzeile (z. B. den Seitenanzeigemodus, die Anzahl der Seitenlinks, die gleichzeitig angezeigt werden sollen, und die Textbeschriftungen des Pager-Steuerelements) mithilfe der PagerSettings Eigenschaft steuern. Die Pagerzeile kann oben, unten oder sowohl oben als auch unten im Steuerelement angezeigt werden, indem sie die Position Eigenschaft festlegen. Sie können auch aus einem von vier integrierten Pager-Anzeigemodi auswählen, indem Sie die Mode Eigenschaft festlegen. In der folgenden Tabelle werden die integrierten Anzeigemodi 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.

Verwenden Sie PagerStyle die Eigenschaft, um die Darstellung der Pagerzeile (einschließlich Hintergrundfarbe, Schriftfarbe und Position) zu steuern.

Hinweis

Das GridView Steuerelement blendet die Pagerzeile automatisch aus, wenn die Datenquelle nur eine Seite mit Datensätzen enthält.

Mit dem GridView 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 GridView 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 GridView Steuerelement den Auslagerungsvorgang verarbeitet hat. Dieses Ereignis wird häufig verwendet, wenn Sie eine Aufgabe ausführen müssen, nachdem der Benutzer zu einer anderen Seite im Steuerelement navigiert hat.
PageIndexChanging Tritt auf, wenn auf eine der Pagerschaltflächen geklickt wird, aber bevor das GridView Steuerelement den Auslagerungsvorgang behandelt. Dieses Ereignis wird häufig verwendet, um den Auslagerungsvorgang abzubrechen.

Gilt für:

Weitere Informationen