DetailsView.AllowPaging 属性

  • 参考

定义

命名空间:
System.Web.UI.WebControls
程序集:
System.Web.dll

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

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

属性值

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 提供了多个事件，可用于执行分页时执行自定义操作。 下表列出了可用的事件。

事件 说明
PageIndexChanged 在单击某一页导航按钮时，但在 DetailsView 控件处理分页操作之后发生。 当用户导航到控件中的其他记录后，通常需要执行任务时，通常会使用此事件。
PageIndexChanging 在单击某一页导航按钮时，但在 DetailsView 控件处理分页操作之前发生。 此事件通常用于取消分页操作。

值 AllowPaging 存储在视图状态中。

适用于

另请参阅