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 且 屬性傳 true 回 ，控制項 DetailsView 會使用資料來源分頁，而不是 CanPage UI 分頁。 在此情況下， DetailsView 控制項只會查詢每個分頁作業所需的資料列。 因此，資料來源分頁比 UI 分頁更有效率。 ObjectDataSourceView只有 物件支援資料來源分頁，而不需修改。

若要啟用分頁功能，請將 AllowPaging 屬性設定為 true 。 您可以使用 屬性來判斷基礎資料來源 PageCount 中的專案總數。 若要判斷目前顯示專案的索引，請使用 PageIndex 屬性。

啟用分頁時，會在 控制項中 DetailsView 自動顯示稱為呼叫器資料列的額外資料列。 頁面巡覽列包含頁面流覽控制項，而且可以顯示在控制項的頂端、底部或兩者。 呼叫器資料列有兩種內建的呼叫器顯示模式：編號的頁面和下一頁和上一頁連結 (預設) 。 編號的頁面模式會顯示個別頁面的連結，讓使用者流覽至特定頁面。 下一個和上一個連結模式會顯示可讓使用者流覽至下一頁或上一頁的控制項。

注意

當資料來源包含少於兩筆記錄時，控制項 DetailsView 會自動隱藏呼叫器資料列。

您可以使用 屬性來控制呼叫器資料列 (的設定，例如呼叫器顯示模式、一次顯示的頁面連結數目，以及呼叫器控制項的文字標籤) PagerSettings 。 若要控制頁面巡覽列的外觀， (包括其背景色彩、字型色彩和位置) ，請使用 PagerStyle 屬性。 控制項 DetailsView 也可讓您定義頁面巡覽列的自訂範本。 如需建立自訂呼叫器資料列範本的詳細資訊，請參閱 PagerTemplate 。

控制項 DetailsView 提供數個事件，您可以在分頁發生時用來執行自訂動作。 下表列出可用的事件。

事件 描述
PageIndexChanged 按一下其中一個頁面巡覽區按鈕時發生 (但在 DetailsView 控制項處理分頁作業之後)。 當您需要在使用者巡覽至 控制項中的不同記錄之後執行工作時，通常會使用此事件。
PageIndexChanging 發生於按一下其中一個頁面巡覽區按鈕時，但是在 DetailsView 控制項處理分頁作業之前。 此事件通常用於取消分頁作業。

的值 AllowPaging 會儲存在檢視狀態中。

適用於

另請參閱