DetailsView.AllowPaging Properti
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.
Mendapatkan atau menetapkan nilai yang menunjukkan apakah fitur paging diaktifkan.
public:
virtual property bool AllowPaging { bool get(); void set(bool value); };
public virtual bool AllowPaging { get; set; }
member this.AllowPaging : bool with get, set
Public Overridable Property AllowPaging As Boolean
Nilai Properti
true
untuk mengaktifkan fitur halaman; jika tidak, false
. Defaultnya adalah false
.
Contoh
Contoh kode berikut menunjukkan cara menggunakan AllowPaging properti untuk mengaktifkan kemampuan DetailsView paging 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 runat="server">
<title>DetailsView AllowPaging Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>DetailsView AllowPaging Example</h3>
<asp:detailsview id="StoresDetailView"
datasourceid="Customers"
autogeneraterows="true"
allowpaging="true"
runat="server">
<headerstyle backcolor="Navy"
forecolor="White"/>
<pagersettings mode="NextPreviousFirstLast"
firstpagetext="First"
lastpagetext="Last"
nextpagetext="Next"
previouspagetext="Prev"/>
<pagerstyle forecolor="White"
backcolor="Blue"
font-names="Arial"
font-size="8" />
</asp:detailsview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:SqlDataSource ID="Customers" runat="server"
ConnectionString=
"<%$ ConnectionStrings:NorthwindConnectionString %>"
SelectCommand="SELECT [CompanyName], [ContactName],
[CustomerID] FROM [Customers]">
</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 runat="server">
<title>DetailsView AllowPaging Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>DetailsView AllowPaging Example</h3>
<asp:detailsview id="StoresDetailView"
datasourceid="Customers"
autogeneraterows="true"
allowpaging="true"
runat="server">
<headerstyle backcolor="Navy"
forecolor="White"/>
<pagersettings mode="NextPreviousFirstLast"
firstpagetext="First"
lastpagetext="Last"
nextpagetext="Next"
previouspagetext="Prev"/>
<pagerstyle forecolor="White"
backcolor="Blue"
font-names="Arial"
font-size="8" />
</asp:detailsview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:SqlDataSource ID="Customers" runat="server"
ConnectionString=
"<%$ ConnectionStrings:NorthwindConnectionString %>"
SelectCommand="SELECT [CompanyName], [ContactName],
[CustomerID] FROM [Customers]">
</asp:SqlDataSource>
</form>
</body>
</html>
Keterangan
Kontrol DetailsView ini memiliki kapabilitas halaman bawaan, yang memungkinkan pengguna untuk menavigasi ke rekaman yang berbeda di sumber data.
DetailsView Kontrol dapat melakukan antarmuka pengguna (UI) dan halaman sumber data. Fitur halaman UI dapat digunakan dengan objek sumber data apa pun yang mendukung System.Collections.ICollection antarmuka. Untuk setiap operasi penomoran halaman, DetailsView kontrol meminta sumber data untuk seluruh pengumpulan data dan memilih baris untuk ditampilkan, pada dasarnya membuang data yang tersisa.
Jika sumber data mengimplementasikan DataSourceView dan CanPage properti mengembalikan true
, DetailsView kontrol akan menggunakan halaman sumber data alih-alih halaman UI. Dalam hal ini, DetailsView kontrol hanya akan mengkueri baris yang diperlukan untuk setiap operasi paging. Dengan demikian, penomor sumber data lebih efisien daripada halaman UI. Hanya objek yang ObjectDataSourceView mendukung halaman sumber data tanpa modifikasi.
Untuk mengaktifkan fitur halaman, atur properti ke AllowPagingtrue
. Anda dapat menentukan jumlah total item di sumber data yang mendasar dengan menggunakan PageCount properti . Untuk menentukan indeks item yang saat ini ditampilkan, gunakan PageIndex properti .
Saat halaman diaktifkan, baris tambahan yang disebut baris pager secara otomatis ditampilkan dalam DetailsView kontrol. Baris pager berisi kontrol navigasi halaman dan dapat ditampilkan di bagian atas, bawah, atau bagian atas dan bawah kontrol. Baris pager memiliki dua mode tampilan pager bawaan: halaman bernomor dan tautan halaman berikutnya dan sebelumnya (default). Mode halaman bernomor menampilkan tautan untuk halaman individual, memungkinkan pengguna menavigasi ke halaman tertentu. Mode tautan berikutnya dan sebelumnya menampilkan kontrol yang memungkinkan pengguna menavigasi ke halaman berikutnya atau sebelumnya.
Catatan
DetailsView Kontrol secara otomatis menyembunyikan baris pager saat sumber data berisi kurang dari dua rekaman.
Anda dapat mengontrol pengaturan baris pager (seperti mode tampilan pager, jumlah tautan halaman untuk ditampilkan pada satu waktu, dan label teks kontrol pager) dengan menggunakan PagerSettings properti . Untuk mengontrol tampilan baris pager (termasuk warna latar belakang, warna font, dan posisinya), gunakan PagerStyle properti . Kontrol juga DetailsView memungkinkan Anda menentukan templat kustom untuk baris pager. Untuk informasi selengkapnya tentang membuat templat baris pager kustom, lihat PagerTemplate.
Kontrol DetailsView menyediakan beberapa peristiwa yang dapat Anda gunakan untuk melakukan tindakan kustom saat paging terjadi. Tabel berikut ini mencantumkan peristiwa yang tersedia.
Kejadian | Deskripsi |
---|---|
PageIndexChanged | Terjadi ketika salah satu tombol pager diklik, tetapi setelah DetailsView kontrol menangani operasi halaman. Kejadian ini biasanya digunakan saat Anda perlu melakukan tugas setelah pengguna menavigasi ke rekaman lain dalam kontrol. |
PageIndexChanging | Terjadi ketika salah satu tombol pager diklik, tetapi sebelum DetailsView kontrol menangani operasi halaman. Kejadian ini sering digunakan untuk membatalkan operasi paging. |
Nilai AllowPaging disimpan dalam status tampilan.