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 屬性時，不會引發這些事件。

適用於

另請參閱