共用方式為


NextPreviousPagerField 類別

定義

表示欄位,該欄位顯示 DataPager 控制項中可讓使用者逐頁查看資料的導覽控制項。

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

範例

下列範例示範如何使用 物件來逐頁 NextPreviousPagerField 查看控件中顯示的 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>NextPreviousPagerField Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NextPreviousPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="ContactIDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td>
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <asp:DataPager runat="server" ID="ContactsDataPager" PagedControlID="ContactsListView">
        <Fields>
          <asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true" />
        </Fields>
      </asp:DataPager>

      <!-- 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>NextPreviousPagerField Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NextPreviousPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="ContactIDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td>
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <asp:DataPager runat="server" ID="ContactsDataPager" PagedControlID="ContactsListView">
        <Fields>
          <asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true" />
        </Fields>
      </asp:DataPager>

      <!-- 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>

備註

類別 NextPreviousPagerField 代表在控件中顯示導覽控件的 DataPager 欄位。 這些導覽控件可用來逐頁瀏覽實作 IPageableItemContainer 介面的控件所顯示的數據,例如 ListView 控件。

類別 NextPreviousPagerField 提供按鈕,讓使用者一次流覽一頁的數據頁面,或跳至數據的第一頁或最後一頁。

您可以使用 屬性來設定按鈕的樣式,來自定義對象ButtonCssClass的外觀NextPreviousPagerField。 您也可以使用 ButtonType 屬性來選擇顯示的按鈕類型。 下表列出可用的按鈕類型。

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

您可以將 屬性設定Visiblefalse,以隱藏 NextPreviousPagerField 控制項中的 DataPager 物件。 您也可以將、 ShowNextPageButtonShowPreviousPageButtonShowLastPageButton 屬性false設定ShowFirstPageButton為 , (第一頁、上一頁、下一頁和最後一頁按鈕) 隱藏個別按鈕。

控制項NextPreviousPagerField可讓您使用、 PreviousPageTextNextPageTextLastPageText 屬性來指定每個按鈕的FirstPageText自訂文字。

ButtonType當 屬性設定ButtonType.Image為 時,您必須為按鈕顯示的影像提供 URL。 您可以藉由設定、PreviousPageImageUrlNextPageImageUrlLastPageImageUrl 屬性,個別設定每個按鈕的FirstPageImageUrl影像。

當 屬性 ButtonType 設定為 ButtonType.Image時,對應的文字屬性會做為影像的替代文字。 例如,屬性所 FirstPageText 指定的文字會顯示為第一頁影像按鈕的替代文字。 在支援工具提示的瀏覽器中,此文字也會顯示為工具提示。

建構函式

NextPreviousPagerField()

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

屬性

ButtonCssClass

取得或設定階層式樣式表 (CSS) 類別,用來呈現瀏覽器上頁面巡覽區欄位的按鈕。

ButtonType

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

DataPager

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

(繼承來源 DataPagerField)
FirstPageImageUrl

取得或設定為第一頁按鈕顯示之影像的 URL。

FirstPageText

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

IsTrackingViewState

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

(繼承來源 DataPagerField)
LastPageImageUrl

取得或設定為 NextPreviousPagerField 物件中最後一頁按鈕顯示之影像的 URL。

LastPageText

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

NextPageImageUrl

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

NextPageText

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

PreviousPageImageUrl

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

PreviousPageText

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

QueryStringHandled

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

(繼承來源 DataPagerField)
QueryStringValue

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

(繼承來源 DataPagerField)
RenderDisabledButtonsAsLabels

取得或設定值,這個值會指出 Label 物件是否將停用的按鈕呈現為 NextPreviousPagerField 控制項。

RenderNonBreakingSpacesBetweenControls

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

ShowFirstPageButton

取得或設定值,這個值表示第一頁按鈕是否顯示在 NextPreviousPagerField 物件中。

ShowLastPageButton

取得或設定數值,這個值表示最後一頁按鈕是否顯示在 NextPreviousPagerField 物件中。

ShowNextPageButton

取得或設定值,這個值表示下一頁按鈕是否顯示在 NextPreviousPagerField 物件中。

ShowPreviousPageButton

取得或設定值,這個值表示上一頁按鈕是否顯示在 NextPreviousPagerField 物件中。

ViewState

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

(繼承來源 DataPagerField)
Visible

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

(繼承來源 DataPagerField)

方法

CloneField()

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

(繼承來源 DataPagerField)
CopyProperties(DataPagerField)

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

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

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

CreateField()

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

Equals(Object)

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

GetHashCode()

做為 NextPreviousPagerField 類別的雜湊函式。

GetQueryStringNavigateUrl(Int32)

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

(繼承來源 DataPagerField)
GetType()

取得目前執行個體的 Type

(繼承來源 Object)
HandleEvent(CommandEventArgs)

處理 NextPreviousPagerField 控制項中發生的事件並執行適當的動作。

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)

適用於

另請參閱