NumericPagerField Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mewakili bidang yang DataPager memungkinkan pengguna memilih halaman menurut nomor halaman.
public ref class NumericPagerField : System::Web::UI::WebControls::DataPagerFieldpublic class NumericPagerField : System.Web.UI.WebControls.DataPagerFieldtype NumericPagerField = class
inherit DataPagerFieldPublic Class NumericPagerField
Inherits DataPagerField- Warisan
Contoh
Contoh berikut menunjukkan cara menggunakan NumericPagerField objek untuk halaman melalui data yang ditampilkan dalam ListView kontrol.
<%@ 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>
Keterangan
Kelas NumericPagerField menampilkan kontrol navigasi dalam DataPager kontrol. Kontrol dapat digunakan untuk halaman melalui data yang ditampilkan oleh kontrol yang mengimplementasikan IPageableItemContainer antarmuka, seperti ListView kontrol. Objek NumericPagerField menampilkan nomor halaman sebagai tombol yang bisa diklik pengguna untuk berpindah ke halaman tertentu. Kontrol juga menampilkan tombol halaman berikutnya dan halaman sebelumnya yang memungkinkan pengguna mengakses lebih banyak halaman data daripada yang ditampilkan oleh kontrol.
Anda bisa mengkustomisasi tampilan NumericPagerField objek dengan menggunakan properti yang tercantum dalam tabel berikut ini.
| Properti | Deskripsi |
|---|---|
| CurrentPageLabelCssClass | Kelas CSS untuk nomor halaman saat ini. |
| NextPreviousButtonCssClass | Kelas CSS untuk tombol halaman berikutnya dan halaman sebelumnya. |
| NumericButtonCssClass | Kelas CSS untuk tombol yang mewakili nomor halaman. |
Anda dapat menggunakan ButtonType properti untuk memilih jenis tombol yang akan ditampilkan. Tabel berikut ini mencantumkan jenis tombol yang tersedia.
| Jenis tombol | Deskripsi |
|---|---|
| ButtonType.Button | Sebuah Button kontrol. |
| ButtonType.Image | Sebuah ImageButton kontrol. |
| ButtonType.Link | Sebuah LinkButton kontrol. |
Kontrol di NumericButtonCssClass dalam objek dirender dengan spasi yang tidak pecah di antaranya. Jika Anda ingin menyesuaikan perilaku ini, Anda dapat menggunakan RenderNonBreakingSpacesBetweenControls properti .
Anda dapat menyembunyikan NumericPagerField objek dalam DataPager kontrol dengan mengatur Visible properti ke false. Anda tidak dapat mengontrol visibilitas tombol halaman berikutnya dan halaman sebelumnya. Mereka ditampilkan oleh kontrol jika kontrol data terkait memiliki halaman tambahan yang tersedia untuk ditampilkan. Anda dapat menggunakan ButtonCount properti untuk menentukan berapa banyak tombol yang ditampilkan dalam NumericPagerField objek. Setiap tombol sesuai dengan nomor halaman.
Anda dapat mengatur teks tombol halaman berikutnya dengan mengatur NextPageText properti . Anda dapat mengatur teks tombol halaman sebelumnya dengan menggunakan PreviousPageText properti .
ButtonType Ketika properti diatur ke ButtonType.Image, Anda harus memberikan URL gambar yang akan ditampilkan untuk halaman berikutnya dan tombol halaman sebelumnya. Anda melakukan ini dengan mengatur NextPageImageUrl properti dan PreviousPageImageUrl . Dalam hal ini, properti teks yang sesuai digunakan sebagai teks alternatif untuk gambar. Misalnya, teks yang ditentukan oleh NextPageImageUrl properti ditampilkan sebagai teks alternatif untuk tombol gambar halaman berikutnya. Pada browser yang mendukung tipsalat, teks ini juga ditampilkan sebagai tipsalat untuk tombol yang sesuai.
Konstruktor
| NumericPagerField() |
Menginisialisasi instans baru kelas NumericPagerField. |
Properti
| ButtonCount |
Mendapatkan atau mengatur jumlah tombol untuk ditampilkan dalam NumericPagerField objek. |
| ButtonType |
Mendapatkan atau mengatur jenis tombol untuk ditampilkan di bidang pager. |
| CurrentPageLabelCssClass |
Mendapatkan atau mengatur kelas lembar gaya bertingkat (CSS) yang digunakan untuk menata nomor halaman saat ini. |
| DataPager |
Mendapatkan referensi ke pager data yang DataPagerField terkait dengan objek. (Diperoleh dari DataPagerField) |
| IsTrackingViewState |
Mendapatkan nilai yang menunjukkan apakah DataPagerField objek melacak perubahan status tampilannya. (Diperoleh dari DataPagerField) |
| NextPageImageUrl |
Mendapatkan atau mengatur URL gambar yang ditampilkan untuk tombol halaman berikutnya dalam NumericPagerField objek . |
| NextPageText |
Mendapatkan atau mengatur teks yang ditampilkan untuk tombol halaman berikutnya. |
| NextPreviousButtonCssClass |
Mendapatkan atau mengatur kelas lembar gaya bertingkat (CSS) yang digunakan untuk menata tombol halaman berikutnya dan halaman sebelumnya dari bidang pager. |
| NumericButtonCssClass |
Mendapatkan atau mengatur kelas lembar gaya bertingkat (CSS) yang digunakan untuk menata tombol nomor halaman bidang pager. |
| PreviousPageImageUrl |
Mendapatkan atau mengatur URL gambar yang ditampilkan untuk tombol halaman sebelumnya di NumericPagerField objek . |
| PreviousPageText |
Mendapatkan atau mengatur teks yang ditampilkan untuk tombol halaman sebelumnya. |
| QueryStringHandled |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah bidang string kueri telah dievaluasi. (Diperoleh dari DataPagerField) |
| QueryStringValue |
Mendapatkan nilai bidang string kueri dari URL permintaan. (Diperoleh dari DataPagerField) |
| RenderNonBreakingSpacesBetweenControls |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah spasi yang tidak melanggar akan dirender di antara kontrol. |
| ViewState |
Mendapatkan kamus informasi status yang memungkinkan Anda menyimpan dan memulihkan status DataPagerField tampilan objek di beberapa permintaan untuk halaman yang sama. (Diperoleh dari DataPagerField) |
| Visible |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah bidang pager data dirender. (Diperoleh dari DataPagerField) |
Metode
| CloneField() |
Membuat salinan objek saat ini yang berasal dari DataPagerField. (Diperoleh dari DataPagerField) |
| CopyProperties(DataPagerField) |
Menyalin properti objek saat ini NumericPagerField ke objek yang ditentukan DataPagerField . |
| CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32) |
Membuat kontrol antarmuka pengguna (UI) untuk objek bidang pager dan menambahkannya ke kontainer yang ditentukan. |
| CreateField() |
Membuat dan mengembalikan instans NumericPagerField baru kelas. |
| Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini NumericPagerField . |
| GetHashCode() |
Berfungsi sebagai fungsi hash untuk NumericPagerField kelas . |
| GetQueryStringNavigateUrl(Int32) |
Membuat URL yang berisi bidang string kueri yang memiliki nomor halaman yang ditentukan. (Diperoleh dari DataPagerField) |
| GetType() |
Mendapatkan instans Type saat ini. (Diperoleh dari Object) |
| HandleEvent(CommandEventArgs) |
Menangani peristiwa yang terjadi di NumericPagerField objek dan melakukan tindakan yang sesuai. |
| LoadViewState(Object) |
Memulihkan informasi status-tampilan yang disimpan sebelumnya. (Diperoleh dari DataPagerField) |
| MemberwiseClone() |
Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object) |
| OnFieldChanged() |
Memunculkan kejadian |
| SaveViewState() |
Menyimpan perubahan yang dibuat pada DataPagerField status tampilan objek. (Diperoleh dari DataPagerField) |
| ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
| TrackViewState() |
DataPagerField Menyebabkan objek melacak perubahan pada status tampilannya sehingga dapat disimpan di properti kontrol ViewState dan bertahan di seluruh permintaan untuk halaman yang sama. (Diperoleh dari DataPagerField) |
Implementasi Antarmuka Eksplisit
| IStateManager.IsTrackingViewState |
Mendapatkan nilai yang menunjukkan apakah DataPagerField objek melacak perubahan status tampilannya. (Diperoleh dari DataPagerField) |
| IStateManager.LoadViewState(Object) |
Memulihkan informasi status-tampilan yang disimpan sebelumnya. (Diperoleh dari DataPagerField) |
| IStateManager.SaveViewState() |
Menyimpan perubahan yang dibuat pada DataPagerField status tampilan objek. (Diperoleh dari DataPagerField) |
| IStateManager.TrackViewState() |
DataPagerField Menyebabkan objek melacak perubahan pada status tampilannya sehingga dapat disimpan di properti kontrol ViewState dan bertahan di seluruh permintaan untuk halaman yang sama. (Diperoleh dari DataPagerField) |
