Sdílet prostřednictvím

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

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

Příklady

Následující příklad kódu ukazuje použití AllowPaging vlastnosti k povolení stránkování schopností 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 System.Collections.ICollection rozhraní. Pro každou operaci stránkování ovládací prvek dotazuje zdroj dat pro celou kolekci dat a vybere řádek, DetailsView 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 použije stránkování zdroje dat místo stránkování uživatelského rozhraní. V tomto případě se DetailsView ovládací prvek dotazuje pouze na řádek potřebný pro každou operaci stránkování. Stránkování zdroje dat je tedy efektivnější než stránkování uživatelského rozhraní. ObjectDataSourceView Stránkování zdroje dat podporuje pouze objekt beze změny.

Chcete-li povolit funkci stránkování, nastavte AllowPaging vlastnost na truehodnotu . Pomocí vlastnosti můžete určit celkový počet položek v podkladovém zdroji PageCount dat. Chcete-li zjistit index aktuálně zobrazené položky, použijte PageIndex vlastnost.

Když je stránkování povolené, v ovládacím DetailsView prvku se automaticky zobrazí další řádek s názvem řádek pager. Řádek pager obsahuje ovládací prvky navigace na stránce a lze je zobrazit v horní, dolní nebo horní i dolní části ovládacího prvku. Řádek pager má dva předdefinované režimy zobrazení pageru: očíslované stránky a další a předchozí odkazy na stránku (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. Následující a předchozí režim odkazů zobrazuje 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 pager (například režim zobrazení pager, počet odkazů na stránky, které se mají zobrazit najednou, a popisek textu ovládacího prvku pager).PagerSettings Pokud chcete nastavit vzhled řádku pageru (včetně jeho barvy pozadí, barvy písma a pozice), použijte PagerStyle tuto vlastnost. Ovládací DetailsView 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í DetailsView 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 DetailsView ovládacím úchytu operace stránkování. Tato událost se běžně používá, když potřebujete provést úlohu po přechodu uživatele na jiný záznam v ovládacím prvku.
PageIndexChanging Nastane při kliknutí na jedno z tlačítek pager, ale před DetailsView ovládacím úchytem operace stránkování. Tato událost se často používá ke zrušení operace stránkování.

Hodnota AllowPaging je uložena ve stavu zobrazení.

Platí pro

Viz také