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

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

Příklady

Následující příklad kódu ukazuje, jak použít AllowPaging vlastnost k povolení stránkování schopnosti DetailsView ovládacího 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>DetailsView AllowPaging Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AllowPaging Example</h3>
                
        <asp:detailsview id="StoresDetailView"
          datasourceid="Customers"
          autogeneraterows="true" 
          allowpaging="true"
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
            
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"/>
            
          <pagerstyle forecolor="White"
            backcolor="Blue"
            font-names="Arial"
            font-size="8" />   
        </asp:detailsview>
            
        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database. -->           
        <asp:SqlDataSource ID="Customers" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthwindConnectionString %>"
          SelectCommand="SELECT [CompanyName], [ContactName], 
             [CustomerID] FROM [Customers]">
        </asp:SqlDataSource>
            
      </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>DetailsView AllowPaging Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AllowPaging Example</h3>
                
        <asp:detailsview id="StoresDetailView"
          datasourceid="Customers"
          autogeneraterows="true" 
          allowpaging="true"
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
            
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"/>
            
          <pagerstyle forecolor="White"
            backcolor="Blue"
            font-names="Arial"
            font-size="8" />   
        </asp:detailsview>
            
        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database. -->           
        <asp:SqlDataSource ID="Customers" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthwindConnectionString %>"
          SelectCommand="SELECT [CompanyName], [ContactName], 
             [CustomerID] FROM [Customers]">
        </asp:SqlDataSource>
            
      </form>
  </body>
</html>

Poznámky

Ovládací DetailsView prvek má integrované možnosti stránkování, které uživateli umožňují přejít na jiný záznam ve zdroji dat.

Ovládací DetailsView prvek může provádět stránkování uživatelského rozhraní i zdroje dat. Funkci stránkování uživatelského rozhraní lze použít s libovolným objektem zdroje dat, který podporuje rozhraní System.Collections.ICollection . Pro každou operaci DetailsView stránkování se ovládací prvek dotazuje zdroje dat pro celou kolekci dat a vybere řádek, který se má zobrazit, a v podstatě zahodí zbývající data.

Pokud zdroj dat implementuje DataSourceView a CanPage vlastnost vrátí true, DetailsView ovládací prvek místo stránkování uživatelského rozhraní použije stránkování zdroje dat. V tomto případě DetailsView se ovládací prvek dotazuje pouze na řádek potřebný pro každou operaci stránkování. Proto je stránkování zdroje dat efektivnější než stránkování uživatelského rozhraní. ObjectDataSourceView Pouze objekt podporuje stránkování zdroje dat bez úprav.

Pokud chcete funkci stránkování povolit, nastavte AllowPaging vlastnost na true. Celkový počet položek v podkladovém zdroji dat můžete určit pomocí PageCount vlastnosti . K určení indexu aktuálně zobrazené položky použijte PageIndex vlastnost .

Pokud je stránkování povolené, v ovládacím prvku se automaticky zobrazí DetailsView další řádek s názvem řádek pageru. Řádek pageru obsahuje ovládací prvky navigace na stránce a lze ho zobrazit nahoře, dole nebo v horní i dolní části ovládacího prvku. Řádek pageru má dva předdefinované režimy zobrazení pageru: číslování stránek a odkazy na další a předchozí stránky (výchozí). Režim číslování stránek zobrazuje odkazy na jednotlivé stránky, což uživateli umožňuje přejít na konkrétní stránku. Další a předchozí režim odkazů zobrazí ovládací prvky, které uživateli umožňují přejít na další nebo předchozí stránku.

Poznámka

Ovládací DetailsView prvek automaticky skryje řádek pageru, pokud zdroj dat obsahuje méně než dva záznamy.

Pomocí vlastnosti můžete řídit nastavení řádku pageru (například režim zobrazení pageru, počet odkazů na stránky, které se mají zobrazit najednou, a textový popisek PagerSettings ovládacího prvku pager). Pokud chcete určit vzhled řádku pageru (včetně barvy pozadí, barvy písma a umístění), použijte PagerStyle vlastnost . Ovládací DetailsView 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í DetailsView 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é DetailsView , 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 jiný záznam v ovládacím prvku.
PageIndexChanging Vyvolá se při kliknutí na jedno z tlačítek pageru, ale předtím, než DetailsView ovládací prvek zpracuje operaci stránkování. Tato událost se často používá ke zrušení operace stránkování.

Hodnota je AllowPaging uložena ve stavu zobrazení.

Platí pro

Viz také