FormView.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 ukazuje, jak pomocí AllowPaging vlastnosti povolit funkci stránkování v ovládacím FormView 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>FormView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>FormView AllowPaging Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID" 
        runat="server">
        
        <pagersettings mode="Numeric"
          position="Bottom"/>
          
        <pagerstyle backcolor="LightBlue"
          horizontalalign="Center"/>
        
        <itemtemplate>
        
          <table>
            <tr>
              <td>
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td>
                <h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3>      
                <%# Eval("Title") %>        
              </td>
            </tr>
          </table>
        
        </itemtemplate> 
                  
      </asp:formview>
          
      <!-- 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="EmployeeSource"
        selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
        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>FormView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>FormView AllowPaging Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID" 
        runat="server">
        
        <pagersettings mode="Numeric"
          position="Bottom"/>
          
        <pagerstyle backcolor="LightBlue"
          horizontalalign="Center"/>
        
        <itemtemplate>
        
          <table>
            <tr>
              <td>
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td>
                <h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3>      
                <%# Eval("Title") %>        
              </td>
            </tr>
          </table>
        
        </itemtemplate> 
                  
      </asp:formview>
          
      <!-- 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="EmployeeSource"
        selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
            
    </form>
  </body>
</html>

Poznámky

Ovládací FormView prvek má integrované možnosti stránkování, které uživateli umožňují přejít na jiný záznam ve zdroji dat. 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. 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í FormView 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 obsahuje čtyři předdefinované režimy zobrazení pageru. Následující tabulka popisuje čtyři režimy.

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.

Poznámka

Ovládací FormView 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 řídit vzhled řádku pageru (včetně barvy pozadí a barvy písma), použijte PagerStyle vlastnost . Ovládací FormView 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í FormView 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é FormView , 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ž FormView ovládací prvek zpracuje operaci stránkování. Tato událost se často používá ke zrušení operace stránkování.

Poznámka

Tyto události nejsou vyvolány při programové změně PageIndex vlastnosti.

Platí pro

Viz také