PagerSettings Kelas

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

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 properti kontrol penomoran halaman dalam kontrol yang mendukung penomoran halaman. Kelas ini tidak dapat diwariskan.

public ref class PagerSettings sealed : System::Web::UI::IStateManager

[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))]
public sealed class PagerSettings : System.Web.UI.IStateManager

[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))>]
type PagerSettings = class
    interface IStateManager

Public NotInheritable Class PagerSettings
Implements IStateManager

Warisan: Object
PagerSettings

Atribut: TypeConverterAttribute

Penerapan: IStateManager

Contoh

Contoh kode berikut menunjukkan cara menggunakan PagerSettings objek yang terkandung dalam PagerSettings properti untuk menyesuaikan teks tombol yang ditampilkan di baris GridView pager 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>PagerSetting Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>PagerSetting Example</h3>
                       
        <asp:gridview id="CustomerGridView"
          datasourceid="CustomerDataSource"
          autogeneratecolumns="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          runat="server">
          
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"   
            position="Bottom"/> 
            
        </asp:gridview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- 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="CustomerDataSource"
          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>PagerSetting Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>PagerSetting Example</h3>
                       
        <asp:gridview id="CustomerGridView"
          datasourceid="CustomerDataSource"
          autogeneratecolumns="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          runat="server">
          
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"   
            position="Bottom"/> 
            
        </asp:gridview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- 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="CustomerDataSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </form>
  </body>
</html>

Keterangan

Kontrol yang mendukung penomoran halaman (seperti GridViewkontrol , , DetailsViewdan FormView ) dapat menampilkan sekumpulan kontrol yang disebut pager yang memungkinkan pengguna menavigasi halaman dalam kontrol. Kelas PagerSettings digunakan oleh kontrol ini untuk mewakili properti pager. Secara umum, PagerSettings objek disimpan dalam PagerSettings properti kontrol. Anda dapat menyesuaikan pager dengan mengatur properti PagerSettings objek.

Pager mendukung beberapa mode tampilan yang berbeda. Untuk menentukan mode untuk menampilkan pager, atur Mode properti . Tabel berikut ini menjelaskan berbagai mode.

Modus	Deskripsi
NextPrevious	Tombol halaman sebelumnya dan halaman berikutnya.
NextPreviousFirstLast	Halaman sebelumnya, halaman berikutnya, halaman pertama, dan tombol -page terakhir.
Numeric	Tombol tautan bernomor untuk mengakses halaman secara langsung.
NumericFirstLast	Tombol tautan bernomor, tautan pertama, dan tautan terakhir.

Mode Saat properti diatur ke NextPrevious, , atau NumericFirstLast nilai, NextPreviousFirstLastAnda dapat mengkustomisasi teks tombol non-numerik dengan mengatur properti yang diperlihatkan dalam tabel berikut.

Harta benda	Deskripsi
FirstPageText	Teks untuk tombol halaman pertama.
PreviousPageText	Teks untuk tombol halaman sebelumnya.
NextPageText	Teks untuk tombol halaman berikutnya.
LastPageText	Teks untuk tombol halaman terakhir.

Sebagai alternatif, Anda juga dapat menampilkan gambar untuk tombol non-numerik dengan mengatur properti seperti yang ditunjukkan dalam tabel berikut.

Harta benda	Deskripsi
FirstPageImageUrl	URL ke gambar yang akan ditampilkan untuk tombol halaman pertama.
PreviousPageImageUrl	URL ke gambar yang akan ditampilkan untuk tombol halaman sebelumnya.
NextPageImageUrl	URL ke gambar yang akan ditampilkan untuk tombol halaman berikutnya.
LastPageImageUrl	URL ke gambar yang akan ditampilkan untuk tombol halaman terakhir.

Nota

Saat properti gambar diatur, properti teks yang sesuai bertindak sebagai teks alternatif untuk gambar. Misalnya, saat FirstPageImageUrl properti diatur, teks yang ditentukan oleh FirstPageText properti ditampilkan sebagai teks alternatif untuk gambar. Pada browser yang mendukung TipsAlat, teks ini juga ditampilkan sebagai TipsAlat untuk tombol yang sesuai.

Mode Saat properti diatur ke Numeric nilai atau NumericFirstLast , Anda dapat menentukan jumlah tombol halaman yang akan ditampilkan di pager dengan mengatur PageButtonCount properti .

Pager dapat ditampilkan di bagian atas, bagian bawah, atau bagian atas dan bawah kontrol. Untuk menentukan posisi pager, atur Position properti . Untuk memperlihatkan atau menyembunyikan pager, gunakan Visible properti .

Konstruktor

Nama	Deskripsi
PagerSettings()	Menginisialisasi instans baru dari kelas PagerSettings.

Properti

Nama	Deskripsi
FirstPageImageUrl	Mendapatkan atau mengatur URL ke gambar yang akan ditampilkan untuk tombol halaman pertama.
FirstPageText	Mendapatkan atau mengatur teks yang akan ditampilkan untuk tombol halaman pertama.
LastPageImageUrl	Mendapatkan atau mengatur URL ke gambar yang akan ditampilkan untuk tombol halaman terakhir.
LastPageText	Mendapatkan atau mengatur teks yang akan ditampilkan untuk tombol halaman terakhir.
Mode	Mendapatkan atau mengatur mode untuk menampilkan kontrol pager dalam kontrol yang mendukung penomoran halaman.
NextPageImageUrl	Mendapatkan atau mengatur URL ke gambar yang akan ditampilkan untuk tombol halaman berikutnya.
NextPageText	Mendapatkan atau mengatur teks yang akan ditampilkan untuk tombol halaman berikutnya.
PageButtonCount	Mendapatkan atau mengatur jumlah tombol halaman yang akan ditampilkan di pager saat Mode properti diatur ke Numeric nilai atau NumericFirstLast .
Position	Mendapatkan atau mengatur nilai yang menentukan lokasi tempat pager ditampilkan.
PreviousPageImageUrl	Mendapatkan atau mengatur URL ke gambar yang akan ditampilkan untuk tombol halaman sebelumnya.
PreviousPageText	Mendapatkan atau mengatur teks yang akan ditampilkan untuk tombol halaman sebelumnya.
Visible	Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol halaman ditampilkan dalam kontrol yang mendukung penomoran halaman.

Metode

Nama	Deskripsi
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
ToString()	Mengambil representasi PagerSettings string objek.

Acara

Nama	Deskripsi
PropertyChanged	Terjadi ketika properti PagerSettings objek mengubah nilai.

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
IStateManager.IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah kontrol server melacak perubahan status tampilannya.
IStateManager.LoadViewState(Object)	Memuat status tampilan objek yang PagerSettings disimpan sebelumnya.
IStateManager.SaveViewState()	Menyimpan status PagerSettings tampilan objek saat ini.
IStateManager.TrackViewState()	Menandai titik awal untuk mulai melacak dan menyimpan perubahan status tampilan ke PagerSettings objek.

Berlaku untuk

Lihat juga

Saran dan Komentar

Apakah halaman ini membantu?