PagerSettings 類別

參考

定義

命名空間:: System.Web.UI.WebControls

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

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

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 物件。

適用於

共用方式為

PagerSettings 類別

定義

範例

備註

建構函式

屬性

方法

事件

明確介面實作

適用於

另請參閱

其他資源