NumericPagerField Kelas

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.Extensions.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 bidang yang DataPager memungkinkan pengguna memilih halaman menurut nomor halaman.

public ref class NumericPagerField : System::Web::UI::WebControls::DataPagerField

public class NumericPagerField : System.Web.UI.WebControls.DataPagerField

type NumericPagerField = class
    inherit DataPagerField

Public Class NumericPagerField
Inherits DataPagerField

Warisan: Object

DataPagerField
NumericPagerField

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 `FieldChanged`. (Diperoleh dari DataPagerField)
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)

Berlaku untuk

Share via