Sdílet prostřednictvím

GridView.AllowPaging Vlastnost

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá nebo nastaví hodnotu označující, zda je povolena funkce stránkování.

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

Hodnota vlastnosti

Boolean

trueje-li povolena funkce stránkování; v opačném případě . false Výchozí hodnota je false.

Příklady

Následující příklad ukazuje, jak použít AllowPaging vlastnost deklarativní povolení stránkovací funkce v ovládacím GridView prvku.


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

Poznámky

Místo zobrazení všech záznamů ve zdroji dat najednou GridView může ovládací prvek automaticky rozdělit záznamy na stránky. Pokud zdroj dat podporuje funkci stránkování, GridView může ovládací prvek využít výhod a poskytovat integrované funkce stránkování. Funkci stránkování lze použít s libovolným objektem zdroje dat, který podporuje System.Collections.ICollection rozhraní nebo zdroj dat, který podporuje funkci stránkování.

Chcete-li povolit funkci stránkování, nastavte AllowPaging vlastnost na truehodnotu . Ve výchozím nastavení GridView ovládací prvek zobrazuje na stránce současně 10 záznamů. Počet záznamů zobrazených na stránce můžete změnit nastavením PageSize vlastnosti. Chcete-li určit celkový počet stránek potřebných k zobrazení obsahu zdroje dat, použijte PageCount vlastnost. Index aktuálně zobrazené stránky můžete určit pomocí PageIndex vlastnosti.

Když je stránkování povolené, v ovládacím GridView prvku se automaticky zobrazí další řádek s názvem řádek pager. Řádek pager obsahuje ovládací prvky, které uživateli umožňují přejít na další stránky. Pomocí vlastnosti můžete řídit nastavení řádku pager (například režim zobrazení pageru, počet odkazů na stránky, které se mají zobrazit najednou, a popisky PagerSettings textu ovládacího prvku pager). Řádek pageru lze zobrazit v horní, dolní nebo horní i dolní části ovládacího prvku nastavením Position vlastnosti. Můžete také vybrat jeden ze čtyř předdefinovaných režimů zobrazení pageru nastavením Mode vlastnosti. Následující tabulka popisuje integrované režimy zobrazení.

Mode Description
PagerButton.NextPrevious Sada ovládacích prvků stránkování, které se skládají z předchozích a dalších tlačítek.
PagerButton.NextPreviousFirstLast Sada ovládacích prvků stránkování, které se skládají z předchozích, dalších, prvních a posledních tlačítek.
PagerButton.Numeric Sada ovládacích prvků stránkování, které se skládají z číselných tlačítek odkazu pro přímý přístup k stránkám. Toto je výchozí režim.
PagerButton.NumericFirstLast Sada ovládacích prvků stránkování, které se skládají z číselných a prvních a posledních tlačítek odkazu.

Pokud chcete nastavit vzhled řádku pageru (včetně jeho barvy pozadí, barvy písma a pozice), použijte PagerStyle tuto vlastnost.

Poznámka:

Ovládací GridView prvek automaticky skryje řádek pageru, pokud zdroj dat obsahuje pouze jednu stránku záznamů.

Ovládací GridView prvek také umožňuje definovat vlastní šablonu pro řádek pageru. Další informace o vytvoření vlastní šablony řádku pager naleznete v tématu PagerTemplate.

Ovládací GridView prvek poskytuje několik událostí, které můžete použít k provedení vlastní akce při stránkování. V následující tabulce jsou uvedeny dostupné události.

Zvláštní událost Description
PageIndexChanged Nastane, když na jedno z tlačítek pager kliknete, ale po GridView ovládacím úchytu operace stránkování. Tato událost se běžně používá, když potřebujete provést úlohu, když uživatel přejde na jinou stránku ovládacího prvku.
PageIndexChanging Nastane při kliknutí na jedno z tlačítek pager, ale před GridView ovládacím úchytem operace stránkování. Tato událost se často používá ke zrušení operace stránkování.

Platí pro

Viz také