PagerSettings.Mode 屬性

  • 參考

定義

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

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

public:
 property System::Web::UI::WebControls::PagerButtons Mode { System::Web::UI::WebControls::PagerButtons get(); void set(System::Web::UI::WebControls::PagerButtons value); };
public System.Web.UI.WebControls.PagerButtons Mode { get; set; }
member this.Mode : System.Web.UI.WebControls.PagerButtons with get, set
Public Property Mode As PagerButtons

屬性值

PagerButtons

其中一個 PagerButtons 值。 預設為 PagerButtons.Numeric。

例外狀況

ArgumentOutOfRangeException

Mode 設定成不是其中一個 PagerButtons 值。

範例

下列程式碼範例示範如何使用 Mode 屬性來指定控制項的呼叫器資料列 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="NumericFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            pagebuttoncount="5"  
            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="NumericFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            pagebuttoncount="5"  
            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>

備註

支援分頁的控制項提供多個模式來顯示分頁控制項。 Mode使用 屬性來指定模式。 下表描述分頁控制項的不同模式。

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

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

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

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

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

注意

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

這個屬性的值會儲存在檢視狀態中。

適用於

另請參閱