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 编号和第一链接和最后链接按钮。

When the Mode property is set to the NextPrevious, NextPreviousFirstLast, or NumericFirstLast value, you can specify custom text for the non-numeric buttons by setting the properties shown in the following table.

属性 说明
FirstPageText 第一页按钮的文本。
PreviousPageText 上一页按钮的文本。
NextPageText 下一页按钮的文本。
LastPageText 最后一页按钮的文本。

或者，还可以通过设置下表中显示的属性来显示非数值按钮的图像。

属性 说明
FirstPageImageUrl 为第一页按钮显示的图像的 URL。
PreviousPageImageUrl 为上一页按钮显示的图像的 URL。
NextPageImageUrl 为下一页按钮显示的图像的 URL。
LastPageImageUrl 为最后一页按钮显示的图像的 URL。

备注

设置图像属性时，相应的文本属性充当图像的备用文本。 例如，设置属性时 FirstPageImageUrl ，由该属性指定的 FirstPageText 文本显示为图像的备用文本。 在支持工具提示的浏览器中，此文本也显示为相应按钮的工具提示。

此属性的值存储在视图状态中。

适用于

另请参阅