FormView.AllowPaging Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
truepovolit funkci stránkování; v opačném případě . false Výchozí hodnota je false.
Příklady
Následující příklad ukazuje, jak pomocí AllowPaging vlastnosti povolit stránkovací funkci 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í 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 . 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 FormView 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á čtyři předdefinované režimy zobrazení pageru. Následující tabulka popisuje čtyři režimy.
| 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. |
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 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ě barvy pozadí a barvy písma), použijte PagerStyle tuto vlastnost. Ovládací FormView 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í FormView 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 FormView 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 FormView ovládacím úchytem operace 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.