DataPagerField 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.

Berfungsi sebagai kelas dasar untuk jenis bidang pager data, yang mewakili kontrol navigasi untuk DataPager kontrol.

public ref class DataPagerField abstract : System::Web::UI::IStateManager

public abstract class DataPagerField : System.Web.UI.IStateManager

type DataPagerField = class
    interface IStateManager

Public MustInherit Class DataPagerField
Implements IStateManager

Warisan: Object
DataPagerField

Turunan: System.Web.UI.WebControls.NextPreviousPagerField

System.Web.UI.WebControls.NumericPagerField

System.Web.UI.WebControls.TemplatePagerField

Penerapan: IStateManager

Contoh

Contoh berikut menunjukkan cara menggunakan NextPreviousPagerFieldobjek , NumericPagerField, dan TemplatePagerField untuk menampilkan kontrol navigasi halaman dalam DataPager kontrol. Objek berasal dari DataPagerField kelas .

<%@ 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>DataPagerField Example</title>    
    <style type="text/css">
      body  
      {
        text-align: center; 
        font: 13px Tahoma, Arial, Helvetica;
      }
      .item
      {
        border-bottom: solid 1px #FFA500;
        font-weight:bold;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>DataPagerField Example</h3>
          
      <asp:ListView ID="ProductsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblProducts" width="350">
            <tr runat="server" id="itemPlaceholder" />
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td class="item">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("Name") %>' />
            </td>
          </tr>
          <tr runat="server">
            <td>
              <asp:Label ID="DescriptionLabel" runat="server" 
                Text='<%#Eval("Description")%>' />
            </td>
          </tr>
        </ItemTemplate>
        <ItemSeparatorTemplate>
          <tr runat="server">
            <td> </td>
          </tr>
        </ItemSeparatorTemplate>
      </asp:ListView>
      <br />

      <asp:DataPager runat="server" 
        ID="ProductsDataPager" 
        PageSize="5"
        PagedControlID="ProductsListView">
        <Fields>
          <asp:TemplatePagerField>
            <PagerTemplate>
            <b>
            Page
            <asp:Label runat="server" ID="CurrentPageLabel" 
              Text="<%# Container.TotalRowCount>0 ? (Container.StartRowIndex / Container.PageSize) + 1 : 0 %>" />
            of
            <asp:Label runat="server" ID="TotalPagesLabel" 
              Text="<%# Math.Ceiling ((double)Container.TotalRowCount / Container.PageSize) %>" />
            </b>
            <br /><br />
            </PagerTemplate>
          </asp:TemplatePagerField>
          
          <asp:NextPreviousPagerField
            ShowFirstPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false" />
          
          <asp:NumericPagerField 
            PreviousPageText="<<"
            NextPageText=">>"
            ButtonCount="10" />
            
          <asp:NextPreviousPagerField
            ShowLastPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false" />
        </Fields>
      </asp:DataPager>

      <!-- 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 P.Name, PD.Description 
                      FROM Production.ProductModel AS PM 
                      INNER JOIN Production.Product AS P ON PM.ProductModelID = P.ProductModelID 
                      INNER JOIN Production.ProductModelProductDescriptionCulture AS PMPDC 
                      ON PM.ProductModelID = PMPDC.ProductModelID 
                      INNER JOIN Production.ProductDescription AS PD 
                      ON PMPDC.ProductDescriptionID = PD.ProductDescriptionID 
                      WHERE (PMPDC.CultureID = 'en')">
      </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>DataPagerField Example</title>    
    <style type="text/css">
      body  
      {
        text-align: center; 
        font: 13px Tahoma, Arial, Helvetica;
      }
      .item
      {
        border-bottom: solid 1px #FFA500;
        font-weight:bold;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>DataPagerField Example</h3>
          
      <asp:ListView ID="ProductsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblProducts" width="350">
            <tr runat="server" id="itemPlaceholder" />
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td class="item">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("Name") %>' />
            </td>
          </tr>
          <tr runat="server">
            <td>
              <asp:Label ID="DescriptionLabel" runat="server" 
                Text='<%#Eval("Description")%>' />
            </td>
          </tr>
        </ItemTemplate>
        <ItemSeparatorTemplate>
          <tr runat="server">
            <td> </td>
          </tr>
        </ItemSeparatorTemplate>
      </asp:ListView>
      <br />

      <asp:DataPager runat="server" 
        ID="ProductsDataPager" 
        PageSize="5"
        PagedControlID="ProductsListView">
        <Fields>
          <asp:TemplatePagerField>
            <PagerTemplate>
            <b>
            Page
            <asp:Label runat="server" ID="CurrentPageLabel" 
              Text="<%# IIf(Container.TotalRowCount>0, (Container.StartRowIndex / Container.PageSize) + 1, 0) %>" />
            of
            <asp:Label runat="server" ID="TotalPagesLabel" 
              Text="<%# Math.Ceiling (System.Convert.ToDouble(Container.TotalRowCount) / Container.PageSize) %>" />
            </b>
            <br /><br />            
            </PagerTemplate>
          </asp:TemplatePagerField>
          
          <asp:NextPreviousPagerField
            ShowFirstPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false" />
          
          <asp:NumericPagerField 
            PreviousPageText="<<"
            NextPageText=">>"
            ButtonCount="10" />
            
          <asp:NextPreviousPagerField
            ShowLastPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false" />
        </Fields>
      </asp:DataPager>

      <!-- 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 P.Name, PD.Description 
                      FROM Production.ProductModel AS PM 
                      INNER JOIN Production.Product AS P ON PM.ProductModelID = P.ProductModelID 
                      INNER JOIN Production.ProductModelProductDescriptionCulture AS PMPDC 
                      ON PM.ProductModelID = PMPDC.ProductModelID 
                      INNER JOIN Production.ProductDescription AS PD 
                      ON PMPDC.ProductDescriptionID = PD.ProductDescriptionID 
                      WHERE (PMPDC.CultureID = 'en')">
      </asp:SqlDataSource>
      
    </form>
  </body>
</html>

Keterangan

Kelas DataPagerField berfungsi sebagai kelas dasar untuk semua jenis bidang pager data. Bidang pager data digunakan oleh DataPager kontrol untuk mewakili kontrol navigasi.

Gunakan kelas yang berasal dari DataPagerField untuk memilih jenis pager mana yang ditampilkan dalam DataPager kontrol. Tabel berikut ini mencantumkan tipe bidang pager data yang tersedia.

Tipe bidang pager	Deskripsi
NextPreviousPagerField	Memungkinkan pengguna menavigasi halaman data satu halaman pada satu waktu, atau melompat ke halaman pertama atau terakhir.
NumericPagerField	Memungkinkan pengguna memilih halaman menurut nomor halaman.
TemplatePagerField	Memungkinkan pengembang halaman membuat UI halaman kustom.

Anda dapat memperoleh dari DataPagerField kelas untuk membuat jenis bidang pager tambahan.

Catatan Bagi Implementer

Saat mewarisi dari DataPagerField kelas , Anda harus mengambil alih anggota berikut:

Konstruktor

DataPagerField()

Menginisialisasi instans baru kelas DataPagerField.

Properti

DataPager	Mendapatkan referensi ke pager data yang DataPagerField terkait dengan objek.
IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah DataPagerField objek melacak perubahan status tampilannya.
QueryStringHandled	Mendapatkan atau menetapkan nilai yang menunjukkan apakah bidang string kueri telah dievaluasi.
QueryStringValue	Mendapatkan nilai bidang string kueri dari URL permintaan.
ViewState	Mendapatkan kamus informasi status yang memungkinkan Anda menyimpan dan memulihkan status DataPagerField tampilan objek di beberapa permintaan untuk halaman yang sama.
Visible	Mendapatkan atau menetapkan nilai yang menunjukkan apakah bidang pager data dirender.

Metode

CloneField()	Membuat salinan objek saat ini yang berasal dari DataPagerField.
CopyProperties(DataPagerField)	Menyalin properti dari objek saat ini yang berasal dari DataPagerField ke objek yang ditentukan DataPagerField .
CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)	Saat ditimpa di kelas turunan, membuat kontrol antarmuka pengguna (UI) untuk objek bidang pager data dan menambahkannya ke kontainer yang ditentukan.
CreateField()	Ketika ditimpa di kelas turunan, membuat objek kosong yang diturunkan DataPagerField.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetQueryStringNavigateUrl(Int32)	Membuat URL yang berisi bidang string kueri yang memiliki nomor halaman yang ditentukan.
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
HandleEvent(CommandEventArgs)	Saat ditimpa di kelas turunan, menangani peristiwa yang terjadi di objek bidang pager data.
LoadViewState(Object)	Memulihkan informasi status tampilan yang disimpan sebelumnya.
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
OnFieldChanged()	Memunculkan kejadian `FieldChanged`.
SaveViewState()	Menyimpan perubahan yang dibuat pada DataPagerField status tampilan objek.
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.

Implementasi Antarmuka Eksplisit

IStateManager.IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah DataPagerField objek melacak perubahan status tampilannya.
IStateManager.LoadViewState(Object)	Memulihkan informasi status tampilan yang disimpan sebelumnya.
IStateManager.SaveViewState()	Menyimpan perubahan yang dibuat pada DataPagerField status tampilan objek.
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.

Berlaku untuk

Bagikan melalui