GridView.AllowPaging Vlastnost

  • Reference

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

truepokud je povolena funkce stránkování; v opačném případě . false Výchozí formát je false.

Příklady

Následující příklad ukazuje, jak použít AllowPaging vlastnost k deklarativnímu povolení funkce stránkování 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

Namísto zobrazení všech záznamů ve zdroji dat najednou GridView může ovládací prvek záznamy automaticky rozdělit na stránky. Pokud zdroj dat podporuje funkci stránkování, GridView může ho ovládací prvek využít a poskytnout integrovanou funkci stránkování. Funkci stránkování je možné použít s libovolným objektem zdroje dat, který podporuje System.Collections.ICollection rozhraní, nebo se zdrojem dat, který podporuje schopnost stránkování.

Pokud chcete funkci stránkování povolit, nastavte AllowPaging vlastnost na true. Ve výchozím nastavení GridView ovládací prvek zobrazuje na stránce 10 záznamů najednou. Počet záznamů zobrazených na stránce můžete změnit nastavením PageSize vlastnosti . Pokud chcete 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 .

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

Režim Description
PagerButton.NextPrevious Sada ovládacích prvků stránkování, které se skládají z předchozího a dalšího tlačítka.
PagerButton.NextPreviousFirstLast Sada ovládacích prvků stránkování, která se skládá 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 očíslovaných tlačítek odkazů pro přímý přístup ke stránkám. To je výchozí režim.
PagerButton.NumericFirstLast Sada ovládacích prvků stránkování, která se skládá z očíslovaných a prvních a posledních tlačítek odkazu.

Pokud chcete určit vzhled řádku pageru (včetně barvy pozadí, barvy písma a umístění), použijte PagerStyle 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 pageru najdete v tématu PagerTemplate.

Ovládací GridView prvek poskytuje několik událostí, které můžete použít k provedení vlastní akce, když dojde k stránkování. Následující tabulka obsahuje seznam dostupných událostí.

Událost Description
PageIndexChanged Vyvolá se při kliknutí na jedno z tlačítek pageru, ale poté GridView , co ovládací prvek zpracuje operaci stránkování. Tato událost se běžně používá, když potřebujete provést úlohu poté, co uživatel přejde na jinou stránku ovládacího prvku.
PageIndexChanging Vyvolá se při kliknutí na jedno z tlačítek pageru, ale předtím, než GridView ovládací prvek zpracuje operaci stránkování. Tato událost se často používá ke zrušení operace stránkování.

Platí pro

Viz také