NextPreviousPagerField Třída
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í.
Představuje pole, které zobrazuje ovládací prvky navigace v ovládacím DataPager prvku, které uživatelům umožňují stránkovat data.
public ref class NextPreviousPagerField : System::Web::UI::WebControls::DataPagerField
public class NextPreviousPagerField : System.Web.UI.WebControls.DataPagerField
type NextPreviousPagerField = class
inherit DataPagerField
Public Class NextPreviousPagerField
Inherits DataPagerField
- Dědičnost
Příklady
Následující příklad ukazuje, jak pomocí objektu NextPreviousPagerField stránkovat prostřednictvím dat zobrazených v ovládacím ListView 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 id="Head1" runat="server">
<title>NextPreviousPagerField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>NextPreviousPagerField Example</h3>
<asp:ListView ID="ContactsListView"
DataSourceID="ContactsDataSource"
runat="server">
<LayoutTemplate>
<table cellpadding="2" width="640px" border="1" runat="server" id="tblContacts">
<tr id="itemPlaceholder" runat="server">
</tr>
</table>
</LayoutTemplate>
<ItemTemplate>
<tr runat="server">
<td>
<asp:Label ID="ContactIDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
</td>
<td>
<asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
</td>
<td>
<asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
</td>
</tr>
</ItemTemplate>
</asp:ListView>
<asp:DataPager runat="server" ID="ContactsDataPager" PagedControlID="ContactsListView">
<Fields>
<asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true" />
</Fields>
</asp:DataPager>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the AdventureWorks sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:SqlDataSource ID="ContactsDataSource" runat="server"
ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
SelectCommand="SELECT [ContactID], [FirstName], [LastName] FROM Person.Contact">
</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 id="Head1" runat="server">
<title>NextPreviousPagerField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>NextPreviousPagerField Example</h3>
<asp:ListView ID="ContactsListView"
DataSourceID="ContactsDataSource"
runat="server">
<LayoutTemplate>
<table cellpadding="2" width="640px" border="1" runat="server" id="tblContacts">
<tr id="itemPlaceholder" runat="server">
</tr>
</table>
</LayoutTemplate>
<ItemTemplate>
<tr runat="server">
<td>
<asp:Label ID="ContactIDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
</td>
<td>
<asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
</td>
<td>
<asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
</td>
</tr>
</ItemTemplate>
</asp:ListView>
<asp:DataPager runat="server" ID="ContactsDataPager" PagedControlID="ContactsListView">
<Fields>
<asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true" />
</Fields>
</asp:DataPager>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the AdventureWorks sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:SqlDataSource ID="ContactsDataSource" runat="server"
ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
SelectCommand="SELECT [ContactID], [FirstName], [LastName] FROM Person.Contact">
</asp:SqlDataSource>
</form>
</body>
</html>
Poznámky
Třída NextPreviousPagerField představuje pole, které zobrazuje navigační ovládací prvky v ovládacím DataPager prvku. Tyto navigační ovládací prvky lze použít ke stránkování dat, která jsou zobrazena ovládacím prvku, který implementuje IPageableItemContainer rozhraní, jako ListView je například ovládací prvek.
Třída NextPreviousPagerField poskytuje tlačítka, která uživatelům umožňují procházet stránky dat po jednotlivých stránkách nebo přejít na první nebo poslední stránku dat.
Vzhled objektu NextPreviousPagerField můžete přizpůsobit pomocí ButtonCssClass vlastnosti a nastavit styl tlačítek. Vlastnost můžete také použít ButtonType k výběru typu zobrazeného tlačítka. Následující tabulka uvádí dostupné typy tlačítek.
| Typ tlačítka | Description |
|---|---|
| Button | Ovládací Button prvek. |
| Image | Ovládací ImageButton prvek. |
| Link | Ovládací LinkButton prvek. |
Objekt v ovládacím DataPager prvku můžete skrýt NextPreviousPagerField nastavením Visible vlastnosti na falsehodnotu . Můžete také skrýt jednotlivá tlačítka (první stránka, předchozí stránka, další stránka a tlačítka poslední stránky) nastavením ShowFirstPageButton, , ShowPreviousPageButtonShowNextPageButtona ShowLastPageButton vlastností na false.
Ovládací NextPreviousPagerField prvek umožňuje zadat vlastní text pro každé tlačítko pomocí FirstPageText, PreviousPageText, NextPageTexta LastPageText vlastnosti.
Pokud je vlastnost nastavena ButtonType na ButtonType.Image, musíte zadat adresu URL obrázku, který se zobrazí pro tlačítko. Obrázky můžete pro každé tlačítko nastavit jednotlivě tak, NextPageImageUrlže nastavíte FirstPageImageUrl, PreviousPageImageUrl, a LastPageImageUrl vlastnosti.
Pokud je vlastnost nastavena ButtonType na ButtonType.Image, odpovídající textová vlastnost funguje jako alternativní text obrázku. Například text určený FirstPageText vlastností se zobrazí jako alternativní text pro tlačítko obrázku první stránky. V prohlížečích, které podporují popisy, se tento text zobrazí také jako popis.
Konstruktory
| Name | Description |
|---|---|
| NextPreviousPagerField() |
Inicializuje novou instanci NextPreviousPagerField třídy. |
Vlastnosti
| Name | Description |
|---|---|
| ButtonCssClass |
Získá nebo nastaví kaskádovou šablonu stylů (CSS), která se používá k vykreslení tlačítek pole pager v prohlížeči. |
| ButtonType |
Získá nebo nastaví typ tlačítka pro zobrazení v poli pager. |
| DataPager |
Získá odkaz na datový pager, ke kterému DataPagerField je objekt přidružen. (Zděděno od DataPagerField) |
| FirstPageImageUrl |
Získá nebo nastaví adresu URL na obrázek, který se zobrazí pro tlačítko první stránky. |
| FirstPageText |
Získá nebo nastaví text, který se zobrazí pro tlačítko první stránky. |
| IsTrackingViewState |
Získá hodnotu, která označuje, zda DataPagerField objekt sleduje své změny stavu zobrazení. (Zděděno od DataPagerField) |
| LastPageImageUrl |
Získá nebo nastaví adresu URL na obrázek, který se zobrazí pro tlačítko poslední stránky v objektu NextPreviousPagerField . |
| LastPageText |
Získá nebo nastaví text, který se zobrazí pro tlačítko poslední stránky. |
| NextPageImageUrl |
Získá nebo nastaví adresu URL na obrázek, který se zobrazí pro tlačítko další stránky v objektu NextPreviousPagerField . |
| NextPageText |
Získá nebo nastaví text, který se zobrazí pro tlačítko další stránky. |
| PreviousPageImageUrl |
Získá nebo nastaví adresu URL na obrázek, který se zobrazí pro tlačítko předchozí stránky v objektu NextPreviousPagerField . |
| PreviousPageText |
Získá nebo nastaví text, který se zobrazí pro tlačítko předchozí stránky. |
| QueryStringHandled |
Získá nebo nastaví hodnotu, která označuje, zda bylo pole řetězce dotazu vyhodnoceno. (Zděděno od DataPagerField) |
| QueryStringValue |
Získá hodnotu pole řetězce dotazu z adresy URL požadavku. (Zděděno od DataPagerField) |
| RenderDisabledButtonsAsLabels |
Získá nebo nastaví hodnotu, která označuje, zda jsou zakázaná tlačítka vykreslena jako Label ovládací prvky objektu NextPreviousPagerField . |
| RenderNonBreakingSpacesBetweenControls |
Získá nebo nastaví hodnotu, která označuje, zda se mezery způsobující přerušení vykreslují mezi ovládacími prvky. |
| ShowFirstPageButton |
Získá nebo nastaví hodnotu, která určuje, zda je tlačítko první stránky zobrazeno v objektu NextPreviousPagerField . |
| ShowLastPageButton |
Získá nebo nastaví hodnotu, která určuje, zda je tlačítko poslední stránky zobrazeno v objektu NextPreviousPagerField . |
| ShowNextPageButton |
Získá nebo nastaví hodnotu, která určuje, zda je tlačítko další stránky zobrazeno v objektu NextPreviousPagerField . |
| ShowPreviousPageButton |
Získá nebo nastaví hodnotu, která označuje, zda je tlačítko předchozí stránky zobrazeno v objektu NextPreviousPagerField . |
| ViewState |
Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení objektu DataPagerField napříč více požadavky na stejnou stránku. (Zděděno od DataPagerField) |
| Visible |
Získá nebo nastaví hodnotu, která označuje, zda je pole datové stránky vykresleno. (Zděděno od DataPagerField) |
Metody
| Name | Description |
|---|---|
| CloneField() |
Vytvoří kopii aktuálního objektu, který je odvozen z DataPagerField. (Zděděno od DataPagerField) |
| CopyProperties(DataPagerField) |
Zkopíruje vlastnosti aktuálního NextPreviousPagerField objektu do zadaného DataPagerField objektu. |
| CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32) |
Vytvoří ovládací prvky uživatelského rozhraní (UI) pro objekt pole pager a přidá je do zadaného kontejneru. |
| CreateField() |
Vytvoří a vrátí novou instanci NextPreviousPagerField třídy. |
| Equals(Object) |
Určuje, zda je zadaný objekt roven aktuálnímu NextPreviousPagerField objektu. |
| GetHashCode() |
Slouží jako hashovací funkce pro NextPreviousPagerField třídu. |
| GetQueryStringNavigateUrl(Int32) |
Vytvoří adresu URL obsahující pole řetězce dotazu, které má zadané číslo stránky. (Zděděno od DataPagerField) |
| GetType() |
Type Získá aktuální instanci. (Zděděno od Object) |
| HandleEvent(CommandEventArgs) |
Zpracovává události, ke kterým dochází v ovládacím NextPreviousPagerField prvku, a provede příslušnou akci. |
| LoadViewState(Object) |
Obnoví informace o stavu zobrazení, které byly uloženy dříve. (Zděděno od DataPagerField) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| OnFieldChanged() |
|
| SaveViewState() |
Uloží změny provedené ve stavu zobrazení objektu DataPagerField . (Zděděno od DataPagerField) |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
| TrackViewState() |
Způsobí, DataPagerField že objekt bude sledovat změny jeho stavu zobrazení, aby je bylo možné uložit do vlastnosti ovládacího prvku ViewState a zachovat napříč požadavky na stejnou stránku. (Zděděno od DataPagerField) |
Explicitní implementace rozhraní
| Name | Description |
|---|---|
| IStateManager.IsTrackingViewState |
Získá hodnotu, která označuje, zda DataPagerField objekt sleduje své změny stavu zobrazení. (Zděděno od DataPagerField) |
| IStateManager.LoadViewState(Object) |
Obnoví informace o stavu zobrazení, které byly uloženy dříve. (Zděděno od DataPagerField) |
| IStateManager.SaveViewState() |
Uloží změny provedené ve stavu zobrazení objektu DataPagerField . (Zděděno od DataPagerField) |
| IStateManager.TrackViewState() |
Způsobí, DataPagerField že objekt bude sledovat změny jeho stavu zobrazení, aby je bylo možné uložit do vlastnosti ovládacího prvku ViewState a zachovat napříč požadavky na stejnou stránku. (Zděděno od DataPagerField) |