NumericPagerField 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 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
- 繼承
範例
下列範例示範如何使用 物件來逐頁 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 屬性。
您可以將 屬性設定 Visible 為 false
,以隱藏 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() |
引發 |
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) |
適用於
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應