PagerSettings 類別

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

表示支援編頁的控制項中分頁控制項的屬性。 此類別無法獲得繼承。

public ref class PagerSettings sealed : System::Web::UI::IStateManager
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))]
public sealed class PagerSettings : System.Web.UI.IStateManager
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))>]
type PagerSettings = class
    interface IStateManager
Public NotInheritable Class PagerSettings
Implements IStateManager
繼承
Object
PagerSettings
屬性
TypeConverterAttribute
實作
IStateManager

範例

下列程式碼範例示範如何使用 PagerSettings 屬性中包含的 PagerSettings 物件，來自訂控制項之頁面巡覽列 GridView 中顯示的按鈕文字。


<%@ 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>PagerSetting Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>PagerSetting Example</h3>
                       
        <asp:gridview id="CustomerGridView"
          datasourceid="CustomerDataSource"
          autogeneratecolumns="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          runat="server">
          
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"   
            position="Bottom"/> 
            
        </asp:gridview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- 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="CustomerDataSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
          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>PagerSetting Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>PagerSetting Example</h3>
                       
        <asp:gridview id="CustomerGridView"
          datasourceid="CustomerDataSource"
          autogeneratecolumns="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          runat="server">
          
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"   
            position="Bottom"/> 
            
        </asp:gridview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- 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="CustomerDataSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </form>
  </body>
</html>

備註

支援分頁 (的控制項，例如 GridView 、 DetailsView 和 FormView 控制項) 可以顯示一組稱為 呼叫器 控制項的控制項，可讓使用者巡覽控制項內的頁面。 這些控制項會使用 類別 PagerSettings 來表示呼叫器的屬性。 一般而言， PagerSettings 物件會儲存在 PagerSettings 控制項的 屬性中。 您可以藉由設定 物件的屬性 PagerSettings 來自訂呼叫器。

呼叫器支援數種不同的顯示模式。 若要指定要顯示頁面巡覽器的模式，請設定 Mode 屬性。 下表描述不同的模式。

[模式] 描述
NextPrevious 上一頁和下一頁按鈕。
NextPreviousFirstLast 上一頁、下一頁、第一頁和最後一頁按鈕。
Numeric 直接存取頁面的編號連結按鈕。
NumericFirstLast Numbered-link、first-link 和 last-link 按鈕。

Mode當 屬性設定為 NextPrevious 、 NextPreviousFirstLast 或 NumericFirstLast 值時，您可以藉由設定下表所示的屬性來自訂非數值按鈕的文字。

屬性 描述
FirstPageText 第一頁按鈕的文字。
PreviousPageText 上一頁按鈕的文字。
NextPageText 下一頁按鈕的文字。
LastPageText 最後一頁按鈕的文字。

或者，您也可以藉由設定屬性來顯示非數值按鈕的影像，如下表所示。

屬性 描述
FirstPageImageUrl 要為第一頁按鈕顯示之影像的 URL。
PreviousPageImageUrl 要為上一頁按鈕顯示之影像的 URL。
NextPageImageUrl 要為下一頁按鈕顯示之影像的 URL。
LastPageImageUrl 要為最後一頁按鈕顯示之影像的 URL。

注意

設定影像屬性時，對應的文字屬性會做為影像的替代文字。 例如，設定 屬性時 FirstPageImageUrl ，屬性所 FirstPageText 指定的文字會顯示為影像的替代文字。 在支援工具提示的瀏覽器中，此文字也會顯示為對應按鈕的工具提示。

Mode當 屬性設定為 Numeric 或 NumericFirstLast 值時，您可以藉由設定 PageButtonCount 屬性，指定要在呼叫器中顯示的頁面按鈕數目。

頁面巡覽器可以顯示在控制項的頂端、底部，或控制項的頂端和底部。 若要指定呼叫器的位置，請設定 Position 屬性。 若要顯示或隱藏呼叫器，請使用 Visible 屬性。

建構函式

PagerSettings()

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

屬性

FirstPageImageUrl

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

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

取得或設定要為最後一頁按鈕顯示之影像的 URL。
LastPageText

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

取得或設定在支援分頁的控制項中顯示頁面巡覽區控制項時所用的模式。
NextPageImageUrl

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

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

取得或設定當 Mode 屬性設定為 Numeric 或 NumericFirstLast 值時，要在頁面巡覽區中顯示的頁面按鈕數目。
Position

取得或設定值，指定顯示頁面巡覽區的位置。
PreviousPageImageUrl

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

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

取得或設定值，指出在支援分頁的控制項中是否顯示分頁控制項。

方法

Equals(Object)

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

(繼承來源 Object)
GetHashCode()

做為預設雜湊函式。

(繼承來源 Object)
GetType()

取得目前執行個體的 Type。

(繼承來源 Object)
MemberwiseClone()

建立目前 Object 的淺層複製。

(繼承來源 Object)
ToString()

擷取 PagerSettings 物件的字串表示。

事件

PropertyChanged

在 PagerSettings 物件的屬性變更值時發生。

明確介面實作

IStateManager.IsTrackingViewState

取得值，指出伺服器控制項是否正在追蹤其檢視狀態變更。
IStateManager.LoadViewState(Object)

載入先前儲存的 PagerSettings 物件檢視狀態。
IStateManager.SaveViewState()

儲存 PagerSettings 物件的目前檢視狀態。
IStateManager.TrackViewState()

標記起點，從此點開始追蹤並將檢視狀態變更儲存至 PagerSettings 物件。

適用於

另請參閱