FormView.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 属性在 控件中 FormView 启用分页功能。


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

注解

控件 FormView 具有内置的分页功能，允许用户导航到数据源中的其他记录。 分页功能可与支持 System.Collections.ICollection 接口的任何数据源对象或支持分页功能的数据源一起使用。

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

启用分页后，控件中 FormView 会自动显示名为“寻呼行”的附加行。 页导航行包含页面导航控件，可以在控件的顶部、底部或同时显示在顶部和底部。 寻呼行具有四种内置的寻呼显示模式。 下表描述了这四种模式。

“模式” 说明
PagerButton.NextPrevious 一组由上一个和下一个按钮组成的分页控件。
PagerButton.NextPreviousFirstLast 一组分页控件，由上一个、下一个、第一个和最后一个按钮组成。
PagerButton.Numeric 一组由用于直接访问页的带编号的链接按钮组成的分页控件。 这是默认模式。
PagerButton.NumericFirstLast 一组分页控件，由编号的第一个和最后一个链接按钮组成。

注意

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

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

控件 FormView 提供多个事件，可用于在发生分页时执行自定义操作。 下表列出了可用的事件。

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

注意

以编程方式更改属性时， PageIndex 不会引发这些事件。

适用于

另请参阅