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 按钮。

When the Mode property is set to the NextPrevious, NextPreviousFirstLast, or NumericFirstLast value you can customize the text of 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 文本将显示为图像的备用文本。在支持工具提示的浏览器中，此文本也显示为相应按钮的工具提示。

当属性 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 类

定义

示例

注解

构造函数

属性

方法

事件

显式接口实现

适用于

另请参阅

其他资源