共用方式為


FormView.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 屬性在 控制項中 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 屬性時,不會引發這些事件。

適用於

另請參閱