FormView.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 halaman 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 berikut menunjukkan cara menggunakan AllowPaging properti untuk mengaktifkan fitur paging dalam FormView 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>FormView AllowPaging Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>FormView AllowPaging Example</h3>
<asp:formview id="EmployeeFormView"
datasourceid="EmployeeSource"
allowpaging="true"
datakeynames="EmployeeID"
runat="server">
<pagersettings mode="Numeric"
position="Bottom"/>
<pagerstyle backcolor="LightBlue"
horizontalalign="Center"/>
<itemtemplate>
<table>
<tr>
<td>
<asp:image id="EmployeeImage"
imageurl='<%# Eval("PhotoPath") %>'
alternatetext='<%# Eval("LastName") %>'
runat="server"/>
</td>
<td>
<h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3>
<%# Eval("Title") %>
</td>
</tr>
</table>
</itemtemplate>
</asp:formview>
<!-- 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="EmployeeSource"
selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
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>FormView AllowPaging Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>FormView AllowPaging Example</h3>
<asp:formview id="EmployeeFormView"
datasourceid="EmployeeSource"
allowpaging="true"
datakeynames="EmployeeID"
runat="server">
<pagersettings mode="Numeric"
position="Bottom"/>
<pagerstyle backcolor="LightBlue"
horizontalalign="Center"/>
<itemtemplate>
<table>
<tr>
<td>
<asp:image id="EmployeeImage"
imageurl='<%# Eval("PhotoPath") %>'
alternatetext='<%# Eval("LastName") %>'
runat="server"/>
</td>
<td>
<h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3>
<%# Eval("Title") %>
</td>
</tr>
</table>
</itemtemplate>
</asp:formview>
<!-- 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="EmployeeSource"
selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</form>
</body>
</html>
Keterangan
Kontrol FormView ini memiliki kemampuan halaman bawaan, yang memungkinkan pengguna untuk menavigasi ke rekaman yang berbeda di sumber data. Fitur halaman dapat digunakan dengan objek sumber data apa pun yang mendukung System.Collections.ICollection antarmuka atau sumber data yang mendukung kemampuan halaman.
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 FormView kontrol. Baris pager berisi kontrol navigasi halaman dan dapat ditampilkan di bagian atas, bawah, atau bagian atas dan bawah kontrol. Baris pager memiliki empat mode tampilan pager bawaan. Tabel berikut ini menjelaskan empat mode.
| Modus | Deskripsi |
|---|---|
PagerButton.NextPrevious |
Sekumpulan kontrol penomoran halaman yang terdiri dari tombol sebelumnya dan berikutnya. |
PagerButton.NextPreviousFirstLast |
Sekumpulan kontrol penomoran halaman yang terdiri dari tombol sebelumnya, berikutnya, pertama, dan terakhir. |
PagerButton.Numeric |
Sekumpulan kontrol penomoran halaman yang terdiri dari tombol tautan bernomor untuk mengakses halaman secara langsung. Ini adalah mode default. |
PagerButton.NumericFirstLast |
Sekumpulan kontrol penomoran halaman yang terdiri dari tombol tautan bernomor dan pertama dan terakhir. |
Nota
FormView 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 dan warna fontnya), gunakan PagerStyle properti . Kontrol ini FormView juga memungkinkan Anda menentukan templat kustom untuk baris pager. Untuk informasi selengkapnya tentang membuat templat baris pager kustom, lihat PagerTemplate.
FormView Kontrol menyediakan beberapa peristiwa yang dapat Anda gunakan untuk melakukan tindakan kustom saat penomor terjadi. Tabel berikut mencantumkan peristiwa yang tersedia.
| Event | Deskripsi |
|---|---|
| PageIndexChanged | Terjadi ketika salah satu tombol pager diklik, tetapi setelah FormView kontrol menangani operasi halaman. Kejadian ini umumnya digunakan saat Anda perlu melakukan tugas setelah pengguna menavigasi ke rekaman lain dalam kontrol. |
| PageIndexChanging | Terjadi ketika salah satu tombol pager diklik, tetapi sebelum FormView kontrol menangani operasi halaman. Kejadian ini sering digunakan untuk membatalkan operasi paging. |
Nota
Peristiwa ini tidak dimunculkan ketika Anda mengubah PageIndex properti secara terprogram.