NextPreviousPagerField 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
表示一个字段,该字段显示 DataPager 控件中使用户能够分页浏览数据的导航控件。
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
- 继承
示例
以下示例演示如何使用 NextPreviousPagerField 对象对控件中显示的 ListView 数据进行分页。
<%@ 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>
注解
类 NextPreviousPagerField 表示在控件中显示导航控件的 DataPager 字段。 这些导航控件可用于分页浏览实现 IPageableItemContainer 接口的控件显示的数据,例如 ListView 控件。
该 NextPreviousPagerField 类提供按钮,使用户能够一次浏览一页的数据页,或跳转到数据的第一页或最后一页。
可以使用属性设置按钮的样式来自定义对象ButtonCssClass的外观NextPreviousPagerField。 还可以使用该 ButtonType 属性选择显示的按钮类型。 下表列出了可用的按钮类型。
按钮类型 | 说明 |
---|---|
Button | 一个 Button 控件。 |
Image | 一个 ImageButton 控件。 |
Link | 一个 LinkButton 控件。 |
You can hide a NextPreviousPagerField object in a DataPager control by setting the Visible property to false
. 还可以通过将属性设置为ShowFirstPageButtonShowLastPageButtonShowPreviousPageButtonShowNextPageButtonfalse
(第一页、上一页、下一页和最后一页按钮) 隐藏各个按钮。
The NextPreviousPagerField control enables you to specify custom text for each button by using the FirstPageText, PreviousPageText, NextPageText, and LastPageText properties.
当属性 ButtonType 设置为 ButtonType.Image
时,必须提供该按钮将显示的图像的 URL。 可以通过设置、PreviousPageImageUrl和NextPageImageUrlLastPageImageUrl属性为每个按钮单独设置FirstPageImageUrl图像。
当属性 ButtonType 设置为 ButtonType.Image
时,相应的文本属性充当图像的备用文本。 例如,属性指定的 FirstPageText 文本显示为第一页图像按钮的备用文本。 在支持工具提示的浏览器中,此文本也显示为工具提示。
构造函数
NextPreviousPagerField() |
初始化 NextPreviousPagerField 类的新实例。 |
属性
方法
CloneField() |
创建从 DataPagerField 派生的当前对象的副本。 (继承自 DataPagerField) |
CopyProperties(DataPagerField) |
将当前 NextPreviousPagerField 对象的属性复制到指定的 DataPagerField 对象。 |
CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32) |
为页导航字段对象创建用户界面 (UI) 控件并将它们添加到指定的容器。 |
CreateField() |
创建并返回 NextPreviousPagerField 类的新实例。 |
Equals(Object) |
确定指定的对象是否等于当前 NextPreviousPagerField 对象。 |
GetHashCode() |
用作 NextPreviousPagerField 类的哈希函数。 |
GetQueryStringNavigateUrl(Int32) |
创建一个 URL,该 URL 包含具有指定页码的查询字符串字段。 (继承自 DataPagerField) |
GetType() |
获取当前实例的 Type。 (继承自 Object) |
HandleEvent(CommandEventArgs) |
处理 NextPreviousPagerField 控件中发生的事件并执行适当的操作。 |
LoadViewState(Object) |
还原以前保存的视图状态信息。 (继承自 DataPagerField) |
MemberwiseClone() |
创建当前 Object 的浅表副本。 (继承自 Object) |
OnFieldChanged() |
引发 |
SaveViewState() |
保存对 DataPagerField 对象的视图状态所做的更改。 (继承自 DataPagerField) |
ToString() |
返回表示当前对象的字符串。 (继承自 Object) |
TrackViewState() |
使 DataPagerField 对象跟踪其视图状态更改,以便这些更改可以存储在控件的 ViewState 属性中并在同一页的不同请求间保留。 (继承自 DataPagerField) |
显式接口实现
IStateManager.IsTrackingViewState |
获取一个值,该值指示 DataPagerField 对象是否在跟踪其视图状态更改。 (继承自 DataPagerField) |
IStateManager.LoadViewState(Object) |
还原以前保存的视图状态信息。 (继承自 DataPagerField) |
IStateManager.SaveViewState() |
保存对 DataPagerField 对象的视图状态所做的更改。 (继承自 DataPagerField) |
IStateManager.TrackViewState() |
使 DataPagerField 对象跟踪其视图状态更改,以便这些更改可以存储在控件的 ViewState 属性中并在同一页的不同请求间保留。 (继承自 DataPagerField) |