共用方式為


NumericPagerField 類別

定義

代表 DataPager 欄位,可讓使用者依照頁碼選取頁面。

public ref class NumericPagerField : System::Web::UI::WebControls::DataPagerField
public class NumericPagerField : System.Web.UI.WebControls.DataPagerField
type NumericPagerField = class
    inherit DataPagerField
Public Class NumericPagerField
Inherits DataPagerField
繼承
NumericPagerField

範例

下列範例示範如何使用 物件來逐頁 NumericPagerField 查看控件中顯示的 ListView 數據。

<%@ 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 id="Head1" runat="server">
    <title>NumericPagerField Example</title>    
    <style type="text/css">
      body 	
      {
        text-align: center;
        font: 12px Arial, Helvetica, sans-serif;
      } 
      table
      {
        padding: 2px 2px 2px 2px;
        border: 1px solid;
        width: 500px;
      }     
      .CurrentPage 
      {
        padding: 2px 6px;
        border: solid 1px #ddd; 
        background: #2E8B57;
        color:White;
      }
      .PrevNext,.PageNumber
      {
        padding: 2px 6px;
        border: solid 1px #ddd;
        text-decoration: none;
        color: #2E8B57;
      }
      .PageNumber:hover, .PrevNext:hover
      {
        background-color: #FFA500;
        color: White;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NumericPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td align="left">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("LastName") + ", " + Eval("FirstName")%>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>
      <br />

      <div>
        <asp:DataPager runat="server" 
          ID="ContactsDataPager" 
          PagedControlID="ContactsListView">
          <Fields>
            <asp:NumericPagerField 
              PreviousPageText="< Prev"
              NextPageText="Next >"
              ButtonCount="10"
              NextPreviousButtonCssClass="PrevNext"
              CurrentPageLabelCssClass="CurrentPage"
              NumericButtonCssClass="PageNumber" />
          </Fields>
        </asp:DataPager>
      </div>
      <br />

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [ContactID], [FirstName], [LastName] 
          FROM Person.Contact">
      </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 id="Head1" runat="server">
    <title>NumericPagerField Example</title>    
    <style type="text/css">
      body 	
      {
        text-align: center;
        font: 12px Arial, Helvetica, sans-serif;
      } 
      table
      {
        padding: 2px 2px 2px 2px;
        border: 1px solid;
        width: 500px;
      }     
      .CurrentPage 
      {
        padding: 2px 6px;
        border: solid 1px #ddd; 
        background: #2E8B57;
        color:White;
      }
      .PrevNext,.PageNumber
      {
        padding: 2px 6px;
        border: solid 1px #ddd;
        text-decoration: none;
        color: #2E8B57;
      }
      .PageNumber:hover, .PrevNext:hover
      {
        background-color: #FFA500;
        color: White;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NumericPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td align="left">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("LastName") & ", " & Eval("FirstName")%>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>
      <br />

      <div>
        <asp:DataPager runat="server" 
          ID="ContactsDataPager" 
          PagedControlID="ContactsListView">
          <Fields>
            <asp:NumericPagerField 
              PreviousPageText="< Prev"
              NextPageText="Next >"
              ButtonCount="10"
              NextPreviousButtonCssClass="PrevNext"
              CurrentPageLabelCssClass="CurrentPage"
              NumericButtonCssClass="PageNumber" />
          </Fields>
        </asp:DataPager>
      </div>
      <br />

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [ContactID], [FirstName], [LastName] 
          FROM Person.Contact">
      </asp:SqlDataSource>
      
    </form>
  </body>
</html>

備註

類別 NumericPagerField 會在控件中 DataPager 顯示導覽控件。 控件可用來逐頁查看實作 介面的控件 IPageableItemContainer 所顯示的數據,例如 ListView 控件。 物件 NumericPagerField 會將頁碼顯示為使用者可以按下以移至特定頁面的按鈕。 控件也會顯示下一頁和上一頁按鈕,讓用戶能夠存取比控件所顯示的數據更多的頁面。

您可以使用下表所列的屬性來自定義物件的外觀 NumericPagerField

屬性 描述
CurrentPageLabelCssClass 目前頁碼的 CSS 類別。
NextPreviousButtonCssClass 下一頁和上一頁按鈕的 CSS 類別。
NumericButtonCssClass 代表頁碼之按鈕的 CSS 類別。

您可以使用 ButtonType 屬性來選取要顯示的按鈕類型。 下表列出可用的按鈕類型。

按鈕類型 描述
ButtonType.Button Button 控制項。
ButtonType.Image ImageButton 控制項。
ButtonType.Link LinkButton 控制項。

物件內的 NumericButtonCssClass 控件會以非中斷空格來呈現。 如果您想要自定義此行為,您可以使用 RenderNonBreakingSpacesBetweenControls 屬性。

您可以將 屬性設定Visiblefalse,以隱藏 NumericPagerField 控制項中的 DataPager 物件。 您無法控制下一頁和上一頁按鈕的可見性。 如果相關聯的數據控制件有其他頁面可供顯示,控件就會顯示它們。 您可以使用 ButtonCount 屬性來指定 物件中顯示的 NumericPagerField 按鈕數目。 每個按鈕都會對應至頁碼。

您可以設定 NextPageText 屬性來設定下一頁按鈕的文字。 您可以使用 屬性來設定上一頁按鈕 PreviousPageText 的文字。

ButtonType當 屬性設定ButtonType.Image為 時,您必須提供將針對下一頁和上一頁按鈕顯示之影像的 URL。 您可以藉由設定 NextPageImageUrlPreviousPageImageUrl 屬性來執行此動作。 在此情況下,對應的文字屬性會當做影像的替代文字使用。 例如,屬性所 NextPageImageUrl 指定的文字會顯示為下一頁影像按鈕的替代文字。 在支援工具提示的瀏覽器中,此文字也會顯示為對應按鈕的工具提示。

建構函式

NumericPagerField()

初始化 NumericPagerField 類別的新執行個體。

屬性

ButtonCount

取得或設定要在 NumericPagerField 物件中顯示的按鈕數目。

ButtonType

取得或設定要在頁面巡覽區欄位中顯示的按鈕類型。

CurrentPageLabelCssClass

取得或設定用來設定目前頁碼樣式的階層式樣式表 (CSS) 類別。

DataPager

取得與 DataPagerField 物件關聯之資料頁面巡覽區的參考。

(繼承來源 DataPagerField)
IsTrackingViewState

取得值,這個值表示 DataPagerField 物件是否正在追蹤它的檢視狀態變更。

(繼承來源 DataPagerField)
NextPageImageUrl

取得或設定針對 NumericPagerField 物件中的下一頁按鈕顯示之影像的 URL。

NextPageText

取得或設定為下一頁按鈕顯示的文字。

NextPreviousButtonCssClass

取得或設定階層式樣式表 (CSS) 類別,這個類別用來設定頁面巡覽區欄位之下一頁和上一頁按鈕的樣式。

NumericButtonCssClass

取得或設定階層式樣式表 (CSS) 類別,這個類別用來設定頁面巡覽區欄位之頁碼按鈕的樣式。

PreviousPageImageUrl

取得或設定針對 NumericPagerField 物件中上一頁按鈕顯示之影像的 URL。

PreviousPageText

取得或設定為上一頁按鈕顯示的文字。

QueryStringHandled

取得或設定值,這個值表示是否已評估查詢字串欄位。

(繼承來源 DataPagerField)
QueryStringValue

從要求的 URL 取得查詢字串欄位的值。

(繼承來源 DataPagerField)
RenderNonBreakingSpacesBetweenControls

取得或設定值,這個值表示是否要在控制項之間呈現不分行空格。

ViewState

取得狀態資訊的字典,可讓您在相同頁面的多個要求之間儲存和還原 DataPagerField 物件的檢視狀態。

(繼承來源 DataPagerField)
Visible

取得或設定值,這個值表示是否呈現資料頁面巡覽區欄位。

(繼承來源 DataPagerField)

方法

CloneField()

建立衍生自 DataPagerField 之目前物件的複本。

(繼承來源 DataPagerField)
CopyProperties(DataPagerField)

將目前 NumericPagerField 物件的屬性複製到指定的 DataPagerField 物件。

CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)

為頁面巡覽區欄位建立使用者介面 (UI) 控制項,並將它們加入至指定的容器。

CreateField()

建立並傳回 NumericPagerField 類別的新執行個體。

Equals(Object)

判斷指定的物件是否等於目前的 NumericPagerField 物件。

GetHashCode()

做為 NumericPagerField 類別的雜湊函式。

GetQueryStringNavigateUrl(Int32)

建立 URL,這個 URL 包含含有所指定頁碼的查詢字串欄位。

(繼承來源 DataPagerField)
GetType()

取得目前執行個體的 Type

(繼承來源 Object)
HandleEvent(CommandEventArgs)

處理 NumericPagerField 物件中發生的事件並執行適當的動作。

LoadViewState(Object)

還原先前儲存的檢視狀態資訊。

(繼承來源 DataPagerField)
MemberwiseClone()

建立目前 Object 的淺層複製。

(繼承來源 Object)
OnFieldChanged()

引發 FieldChanged 事件。

(繼承來源 DataPagerField)
SaveViewState()

儲存 DataPagerField 物件的檢視狀態變更。

(繼承來源 DataPagerField)
ToString()

傳回代表目前物件的字串。

(繼承來源 Object)
TrackViewState()

DataPagerField 追蹤其檢視狀態變更,以將變更儲存在控制項的 ViewState 物件中,並在相同頁面的其他要求之間保存。

(繼承來源 DataPagerField)

明確介面實作

IStateManager.IsTrackingViewState

取得值,這個值表示 DataPagerField 物件是否正在追蹤它的檢視狀態變更。

(繼承來源 DataPagerField)
IStateManager.LoadViewState(Object)

還原先前儲存的檢視狀態資訊。

(繼承來源 DataPagerField)
IStateManager.SaveViewState()

儲存 DataPagerField 物件的檢視狀態變更。

(繼承來源 DataPagerField)
IStateManager.TrackViewState()

DataPagerField 追蹤其檢視狀態變更,以將變更儲存在控制項的 ViewState 物件中,並在相同頁面的其他要求之間保存。

(繼承來源 DataPagerField)

適用於

另請參閱