NumericPagerField 类

参考

定义

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

程序集:: System.Web.Extensions.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

表示一个 DataPager 字段，该字段可使用户按页码选择页。

public ref class NumericPagerField : System::Web::UI::WebControls::DataPagerField

public class NumericPagerField : System.Web.UI.WebControls.DataPagerField

type NumericPagerField = class
    inherit DataPagerField

Public Class NumericPagerField
Inherits DataPagerField

继承: Object

DataPagerField
NumericPagerField

示例

以下示例演示如何使用 NumericPagerField 对象对控件中显示的 ListView 数据进行分页。

<%@ 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 id="Head1" runat="server">
    <title>NumericPagerField Example</title>    
    <style type="text/css">
      body 	
      {
        text-align: center;
        font: 12px Arial, Helvetica, sans-serif;
      } 
      table
      {
        padding: 2px 2px 2px 2px;
        border: 1px solid;
        width: 500px;
      }     
      .CurrentPage 
      {
        padding: 2px 6px;
        border: solid 1px #ddd; 
        background: #2E8B57;
        color:White;
      }
      .PrevNext,.PageNumber
      {
        padding: 2px 6px;
        border: solid 1px #ddd;
        text-decoration: none;
        color: #2E8B57;
      }
      .PageNumber:hover, .PrevNext:hover
      {
        background-color: #FFA500;
        color: White;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NumericPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td align="left">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("LastName") + ", " + Eval("FirstName")%>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>
      <br />

      <div>
        <asp:DataPager runat="server" 
          ID="ContactsDataPager" 
          PagedControlID="ContactsListView">
          <Fields>
            <asp:NumericPagerField 
              PreviousPageText="< Prev"
              NextPageText="Next >"
              ButtonCount="10"
              NextPreviousButtonCssClass="PrevNext"
              CurrentPageLabelCssClass="CurrentPage"
              NumericButtonCssClass="PageNumber" />
          </Fields>
        </asp:DataPager>
      </div>
      <br />

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [ContactID], [FirstName], [LastName] 
          FROM Person.Contact">
      </asp:SqlDataSource>
      
    </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 id="Head1" runat="server">
    <title>NumericPagerField Example</title>    
    <style type="text/css">
      body 	
      {
        text-align: center;
        font: 12px Arial, Helvetica, sans-serif;
      } 
      table
      {
        padding: 2px 2px 2px 2px;
        border: 1px solid;
        width: 500px;
      }     
      .CurrentPage 
      {
        padding: 2px 6px;
        border: solid 1px #ddd; 
        background: #2E8B57;
        color:White;
      }
      .PrevNext,.PageNumber
      {
        padding: 2px 6px;
        border: solid 1px #ddd;
        text-decoration: none;
        color: #2E8B57;
      }
      .PageNumber:hover, .PrevNext:hover
      {
        background-color: #FFA500;
        color: White;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NumericPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td align="left">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("LastName") & ", " & Eval("FirstName")%>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>
      <br />

      <div>
        <asp:DataPager runat="server" 
          ID="ContactsDataPager" 
          PagedControlID="ContactsListView">
          <Fields>
            <asp:NumericPagerField 
              PreviousPageText="< Prev"
              NextPageText="Next >"
              ButtonCount="10"
              NextPreviousButtonCssClass="PrevNext"
              CurrentPageLabelCssClass="CurrentPage"
              NumericButtonCssClass="PageNumber" />
          </Fields>
        </asp:DataPager>
      </div>
      <br />

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [ContactID], [FirstName], [LastName] 
          FROM Person.Contact">
      </asp:SqlDataSource>
      
    </form>
  </body>
</html>

注解

类 NumericPagerField 在控件中 DataPager 显示导航控件。控件可用于分页浏览实现 IPageableItemContainer 接口的控件（如 ListView 控件）显示的数据。对象 NumericPagerField 将页码显示为按钮，用户可以单击这些按钮以移动到特定页面。控件还显示下一页和上一页按钮，使用户能够访问比控件显示的数据页更多的数据页。

可以使用下表中列出的属性自定义对象的外观 NumericPagerField 。

属性	说明
CurrentPageLabelCssClass	当前页码的 CSS 类。
NextPreviousButtonCssClass	下一页和上一页按钮的 CSS 类。
NumericButtonCssClass	表示页码的按钮的 CSS 类。

可以使用 ButtonType 属性来选择将显示的按钮类型。下表列出了可用的按钮类型。

按钮类型	说明
ButtonType.Button	一个 Button 控件。
ButtonType.Image	一个 ImageButton 控件。
ButtonType.Link	一个 LinkButton 控件。

对象内的 NumericButtonCssClass 控件呈现时，它们之间有不间断的空格。如果要自定义此行为，可以使用 RenderNonBreakingSpacesBetweenControls 属性。

可以通过将属性设置为 Visiblefalse来隐藏NumericPagerField控件中的DataPager对象。无法控制下一页和上一页按钮的可见性。如果关联的数据控件具有可供显示的其他页面，则控件将显示这些页面。可以使用 ButtonCount 属性指定对象中显示的 NumericPagerField 按钮数。每个按钮对应于一个页码。

可以通过设置属性来设置 NextPageText 下一页按钮的文本。可以使用属性设置上一页按钮 PreviousPageText 的文本。

当属性 ButtonType 设置为 ButtonType.Image时，必须提供将为下一页和上一页按钮显示的图像的 URL。可以通过设置 NextPageImageUrl 和 PreviousPageImageUrl 属性来执行此操作。在这种情况下，相应的文本属性将用作图像的备用文本。例如，由 NextPageImageUrl 属性指定的文本显示为下一页图像按钮的备用文本。在支持工具提示的浏览器上，此文本也显示为相应按钮的工具提示。

构造函数

NumericPagerField()

初始化 NumericPagerField 类的新实例。

属性

ButtonCount	获取或设置要在 NumericPagerField 对象中显示的按钮的数目。
ButtonType	获取或设置要在页导航字段中显示的按钮类型。
CurrentPageLabelCssClass	获取或设置用于设置当前页码样式的级联样式表 (CSS) 类。
DataPager	获取对数据页导航的引用，该数据页导航与 DataPagerField 对象关联。 (继承自 DataPagerField)
IsTrackingViewState	获取一个值，该值指示 DataPagerField 对象是否在跟踪其视图状态更改。 (继承自 DataPagerField)
NextPageImageUrl	获取或设置为 NumericPagerField 对象中的下一页按钮显示的图像的 URL。
NextPageText	获取或设置为下一页按钮显示的文本。
NextPreviousButtonCssClass	获取或设置一个级联样式表 (CSS) 类，用于为页导航字段的下一页按钮和上一页按钮设置样式。
NumericButtonCssClass	获取或设置一个级联样式表 (CSS) 类，用于为页导航字段的页码按钮设置样式。
PreviousPageImageUrl	获取或设置为 NumericPagerField 对象中的上一页按钮显示的图像的 URL。
PreviousPageText	获取或设置为上一页按钮显示的文本。
QueryStringHandled	获取或设置一个值，该值指示是否已对查询字符串字段进行计算。 (继承自 DataPagerField)
QueryStringValue	从请求的 URL 获取查询字符串字段的值。 (继承自 DataPagerField)
RenderNonBreakingSpacesBetweenControls	获取或设置一个值，该值指示是否将在控件之间呈现非换行空格。
ViewState	获取状态信息的字典，这些信息使您可以在同一页的多个请求间保存和还原 DataPagerField 对象的视图状态。 (继承自 DataPagerField)
Visible	获取或设置指示是否呈现数据页导航字段的值。 (继承自 DataPagerField)

方法

CloneField()	创建从 DataPagerField 派生的当前对象的副本。 (继承自 DataPagerField)
CopyProperties(DataPagerField)	将当前 NumericPagerField 对象的属性复制到指定的 DataPagerField 对象。
CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)	为页导航字段对象创建用户界面 (UI) 控件并将它们添加到指定的容器。
CreateField()	创建并返回 NumericPagerField 类的新实例。
Equals(Object)	确定指定的对象是否等于当前 NumericPagerField 对象。
GetHashCode()	用作 NumericPagerField 类的哈希函数。
GetQueryStringNavigateUrl(Int32)	创建一个 URL，该 URL 包含具有指定页码的查询字符串字段。 (继承自 DataPagerField)
GetType()	获取当前实例的 Type。 (继承自 Object)
HandleEvent(CommandEventArgs)	处理 NumericPagerField 对象中发生的事件并执行适当的操作。
LoadViewState(Object)	还原以前保存的视图状态信息。 (继承自 DataPagerField)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
OnFieldChanged()	引发 `FieldChanged` 事件。 (继承自 DataPagerField)
SaveViewState()	保存对 DataPagerField 对象的视图状态所做的更改。 (继承自 DataPagerField)
ToString()	返回表示当前对象的字符串。 (继承自 Object)
TrackViewState()	使 DataPagerField 对象跟踪其视图状态更改，以便这些更改可以存储在控件的 ViewState 属性中并在同一页的不同请求间保留。 (继承自 DataPagerField)

显式接口实现

IStateManager.IsTrackingViewState	获取一个值，该值指示 DataPagerField 对象是否在跟踪其视图状态更改。 (继承自 DataPagerField)
IStateManager.LoadViewState(Object)	还原以前保存的视图状态信息。 (继承自 DataPagerField)
IStateManager.SaveViewState()	保存对 DataPagerField 对象的视图状态所做的更改。 (继承自 DataPagerField)
IStateManager.TrackViewState()	使 DataPagerField 对象跟踪其视图状态更改，以便这些更改可以存储在控件的 ViewState 属性中并在同一页的不同请求间保留。 (继承自 DataPagerField)

适用于

通过

NumericPagerField 类

定义

示例

注解

构造函数

属性

方法

显式接口实现

适用于

另请参阅

其他资源