Bagikan melalui

GridView.AllowPaging Properti

Definisi

Ruang nama:
System.Web.UI.WebControls
Rakitan:
System.Web.dll

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

Boolean

true jika fitur paging diaktifkan; jika tidak, false. Defaultnya adalah false.

Contoh

Contoh berikut menunjukkan cara menggunakan AllowPaging properti untuk mengaktifkan fitur paging secara deklaratif dalam GridView 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>GridView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView AllowPaging Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">
                
        <pagersettings mode="Numeric"
          position="Bottom"           
          pagebuttoncount="10"/>
                      
        <pagerstyle backcolor="LightBlue"
          height="30px"
          verticalalign="Bottom"
          horizontalalign="Center"/>
                
      </asp:gridview>
            
      <!-- 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="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        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>GridView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView AllowPaging Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">
                
        <pagersettings mode="Numeric"
          position="Bottom"           
          pagebuttoncount="10"/>
                      
        <pagerstyle backcolor="LightBlue"
          height="30px"
          verticalalign="Bottom"
          horizontalalign="Center"/>
                
      </asp:gridview>
            
      <!-- 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="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
        
    </form>
  </body>
</html>

Keterangan

Alih-alih menampilkan semua rekaman di sumber data secara bersamaan, GridView kontrol dapat secara otomatis memecah rekaman menjadi halaman. Jika sumber data mendukung kemampuan halaman, GridView kontrol dapat memanfaatkannya dan menyediakan fungsionalitas halaman bawaan. 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. Secara default, GridView kontrol menampilkan 10 rekaman pada halaman pada satu waktu. Anda bisa mengubah jumlah rekaman yang ditampilkan di halaman dengan mengatur PageSize properti . Untuk menentukan jumlah total halaman yang diperlukan untuk menampilkan konten sumber data, gunakan PageCount properti . Anda dapat menentukan indeks halaman yang saat ini ditampilkan dengan menggunakan PageIndex properti .

Saat halaman diaktifkan, baris tambahan yang disebut baris pager secara otomatis ditampilkan dalam GridView kontrol. Baris pager berisi kontrol yang memungkinkan pengguna menavigasi ke halaman lain. Anda dapat mengontrol pengaturan baris pager (seperti mode tampilan pager, jumlah tautan halaman yang akan ditampilkan pada satu waktu, dan label teks kontrol pager) dengan menggunakan PagerSettings properti . Baris pager dapat ditampilkan di bagian atas, bawah, atau bagian atas dan bawah kontrol dengan mengatur Position properti . Anda juga dapat memilih dari salah satu dari empat mode tampilan pager bawaan dengan mengatur Mode properti . Tabel berikut ini menjelaskan mode tampilan bawaan.

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.

Untuk mengontrol tampilan baris pager (termasuk warna latar belakang, warna font, dan posisinya), gunakan PagerStyle properti .

Nota

GridView Kontrol secara otomatis menyembunyikan baris pager saat sumber data hanya berisi satu halaman rekaman.

Kontrol ini GridView juga memungkinkan Anda menentukan templat kustom untuk baris pager. Untuk informasi selengkapnya tentang membuat templat baris pager kustom, lihat PagerTemplate.

GridView 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 GridView kontrol menangani operasi halaman. Kejadian ini biasanya digunakan saat Anda perlu melakukan tugas setelah pengguna menavigasi ke halaman lain dalam kontrol.
PageIndexChanging Terjadi ketika salah satu tombol pager diklik, tetapi sebelum GridView kontrol menangani operasi halaman. Kejadian ini sering digunakan untuk membatalkan operasi paging.

Berlaku untuk

Lihat juga