GridView.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, wenn das Pagingfeature aktiviert ist, andernfalls false. Der Standardwert ist false.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie die Eigenschaft verwenden, um das AllowPaging Pagingfeature im GridView Steuerelement deklarativ 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>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

Statt alle Datensätze in der Datenquelle gleichzeitig anzuzeigen, kann das GridView Steuerelement die Datensätze automatisch in Seiten unterbrechen. 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 die System.Collections.ICollection Pagingfunktion unterstützt.

Um das Paging-Feature zu aktivieren, legen Sie die AllowPaging Eigenschaft auf true. Standardmäßig zeigt das GridView Steuerelement 10 Datensätze auf einer Seite gleichzeitig an. Sie können die Anzahl der Datensätze ändern, die auf einer Seite angezeigt werden, 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 bestimmen.

Wenn die Seitenseite aktiviert ist, wird eine zusätzliche Zeile, die als Pagerzeile bezeichnet wird, automatisch 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 Pagersteuerelements) mithilfe PagerSettings der Eigenschaft steuern. Die Pagerzeile kann oben, unten oder sowohl oben als auch unten des Steuerelements angezeigt werden, indem Sie die Position Eigenschaft festlegen. Sie können auch aus einem der vier integrierten Pageranzeigemodi auswählen, indem Sie die Mode Eigenschaft festlegen. In der folgenden Tabelle werden die integrierten Anzeigemodi beschrieben.

Mode	BESCHREIBUNG
`PagerButton.NextPrevious`	Eine Reihe von Paginationssteuerelementen, die aus vorherigen und nächsten Schaltflächen bestehen.
`PagerButton.NextPreviousFirstLast`	Eine Reihe von Paginationssteuerelementen, die aus vorherigen, nächsten, 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`	Eine Reihe von Paginationssteuerelementen, die aus nummerierten und letzten Linkschaltflächen bestehen.

Zum Steuern der Darstellung der Pagerzeile (einschließlich seiner Hintergrundfarbe, Schriftartfarbe und Position) verwenden Sie die PagerStyle Eigenschaft.

Hinweis

Das GridView Steuerelement blendet die Pagerzeile automatisch aus, wenn die Datenquelle nur eine Seite von 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 bietet mehrere Ereignisse, mit denen Sie eine benutzerdefinierte Aktion ausführen können, wenn die Paging auftritt. 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 GridView-Steuerelement den Pagingvorgang behandelt 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.
PageIndexChanging	Tritt ein, wenn auf eine der Pagerschaltflächen geklickt wird, allerdings bevor das GridView-Steuerelement den Pagingvorgang behandelt. Dieses Ereignis wird häufig verwendet, um den Pagingvorgang abzubrechen.

Gilt für