语言

DetailsView.AllowPaging 属性

定义

获取或设置一个值,该值指示是否启用分页功能。

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

属性值

true 启用分页功能;否则,为 false. 默认值为 false。

示例

下面的代码示例演示如何使用 AllowPaging 属性启用控件的 DetailsView 分页功能。

<%@ 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>

注解

该 DetailsView 控件具有内置分页功能,允许用户导航到数据源中的不同记录。

该 DetailsView 控件可以执行用户界面(UI)和数据源分页。 UI 分页功能可与支持 System.Collections.ICollection 接口的任何数据源对象一起使用。 对于每个分页操作,控件 DetailsView 会查询整个数据收集的数据源,并选择要显示的行,实质上是放弃剩余数据。

如果数据源实现 DataSourceView 并 CanPage 返回 true属性,控件 DetailsView 将使用数据源分页而不是 UI 分页。 在这种情况下,控件 DetailsView 将仅查询每个分页操作所需的行。 因此,数据源分页比 UI 分页更有效。 ObjectDataSourceView只有对象支持数据源分页,而无需修改。

若要启用分页功能,请将 AllowPaging 属性设置为 true. 可以使用该属性确定基础数据源 PageCount 中的项总数。 若要确定当前显示的项的索引,请使用 PageIndex 该属性。

启用分页后,控件中 DetailsView 会自动显示一个名为寻呼行的其他行。 寻呼行包含页面导航控件,可显示在控件的顶部、底部或顶部和底部。 寻呼行具有两种内置寻呼显示模式:编号页和下一页链接(默认值)。 编号页模式显示各个页面的链接,允许用户导航到特定页面。 下一个和上一个链接模式显示允许用户导航到下一页或上一页的控件。

注释

当数据源包含少于两条记录时,控件 DetailsView 会自动隐藏寻呼行。

可以使用属性控制寻呼行的设置(例如寻呼模式、一次显示的页链接数和寻呼控件的文本标签 PagerSettings )。 若要控制寻呼行的外观(包括其背景色、字体颜色和位置),请使用该 PagerStyle 属性。 该 DetailsView 控件还允许为寻呼行定义自定义模板。 有关创建自定义寻呼行模板的详细信息,请参阅 PagerTemplate。

该 DetailsView 控件提供了多个事件,可用于在分页时执行自定义操作。 下表列出了可用事件。

事件 Description
PageIndexChanged 单击其中一个寻呼按钮时发生,但在控件处理分页操作之后 DetailsView 发生。 用户在控件中导航到不同记录后,通常会用此事件来执行功能。
PageIndexChanging 单击其中一个寻呼按钮,但在控件处理分页操作之前 DetailsView 发生。 此事件通常用于取消分页操作。

该值 AllowPaging 存储在视图状态中。

适用于

另请参阅