GridView.AllowPaging Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar eller anger ett värde som anger om växlingsfunktionen är aktiverad.

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

Egenskapsvärde

Boolean

trueom växlingsfunktionen är aktiverad; annars . false Standardvärdet är false.

Exempel

I följande exempel visas hur du använder AllowPaging egenskapen för att deklarativt aktivera växlingsfunktionen i GridView kontrollen.


<%@ 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>

Kommentarer

I stället för att visa alla poster i datakällan samtidigt GridView kan kontrollen automatiskt dela upp posterna till sidor. Om datakällan stöder växlingsfunktionen GridView kan kontrollen dra nytta av det och tillhandahålla inbyggda växlingsfunktioner. Växlingsfunktionen kan användas med alla datakällans objekt som stöder System.Collections.ICollection gränssnittet eller en datakälla som stöder växlingsfunktionen.

Om du vill aktivera växlingsfunktionen anger du AllowPaging egenskapen till true. Som standard GridView visar kontrollen 10 poster på en sida i taget. Du kan ändra antalet poster som visas på en sida genom att ange egenskapen PageSize . Använd egenskapen för att fastställa det totala antalet sidor som krävs för att visa innehållet i PageCount datakällan. Du kan fastställa indexet för den sida som visas för närvarande med hjälp PageIndex av egenskapen .

När växling är aktiverat visas en ytterligare rad med namnet pager-raden automatiskt i GridView kontrollen. Pager-raden innehåller kontroller som gör att användaren kan navigera till de andra sidorna. Du kan styra inställningarna för sidsidesraden (till exempel visningsläget för sidsökaren, antalet sidlänkar som ska visas i taget och sidkontrollens textetiketter) med hjälp PagerSettings av egenskapen . Pager-raden kan visas överst, längst ned eller både överst och längst ned i kontrollen genom att ange Position egenskapen. Du kan också välja mellan ett av fyra inbyggda visningslägen för sidsökare genom att ange egenskapen Mode . I följande tabell beskrivs de inbyggda visningslägena.

Läge Description
PagerButton.NextPrevious En uppsättning sidnumreringskontroller som består av föregående och nästa knappar.
PagerButton.NextPreviousFirstLast En uppsättning sidnumreringskontroller som består av föregående, nästa, första och sista knappar.
PagerButton.Numeric En uppsättning sidnumreringskontroller som består av numrerade länkknappar för att komma åt sidor direkt. Det här är standardläget.
PagerButton.NumericFirstLast En uppsättning sidnumreringskontroller som består av numrerade och första och sista länkknappar.

Om du vill styra utseendet på sidsökarraden (inklusive dess bakgrundsfärg, teckenfärg och position) använder du PagerStyle egenskapen .

Note

Kontrollen GridView döljer automatiskt pager-raden när datakällan endast innehåller en sida med poster.

Med GridView kontrollen kan du också definiera en anpassad mall för pager-raden. Mer information om hur du skapar en anpassad sidradsmall finns i PagerTemplate.

Kontrollen GridView innehåller flera händelser som du kan använda för att utföra en anpassad åtgärd vid växling. I följande tabell visas tillgängliga händelser.

Händelse Description
PageIndexChanged Inträffar när en av sidsidesknapparna klickas, men när GridView kontrollen har hanterat växlingsåtgärden. Den här händelsen används ofta när du behöver utföra en uppgift när användaren har navigerat till en annan sida i kontrollen.
PageIndexChanging Inträffar när en av sidsidesknapparna klickas, men innan GridView kontrollen hanterar växlingsåtgärden. Den här händelsen används ofta för att avbryta växlingsåtgärden.

Gäller för

Se även