DataPager.Fields 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 kumpulan DataPagerField objek yang mewakili bidang pager yang ditentukan dalam DataPager kontrol.
public:
virtual property System::Web::UI::WebControls::DataPagerFieldCollection ^ Fields { System::Web::UI::WebControls::DataPagerFieldCollection ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.DataPagerFieldCollection Fields { get; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.Fields : System.Web.UI.WebControls.DataPagerFieldCollection
Public Overridable ReadOnly Property Fields As DataPagerFieldCollection
Nilai Properti
Objek koleksi yang berisi semua bidang pager yang ditentukan dalam DataPager kontrol.
- Atribut
Contoh
Contoh berikut menunjukkan cara menambahkan bidang pager secara deklaratif ke Fields kumpulan DataPager 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>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>
Contoh berikut menunjukkan cara menggunakan Fields properti untuk menambahkan NextPreviousPagerField objek secara dinamis ke DataPager kontrol. Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk NextPreviousPagerField konstruktor.
void Page_Load(Object sender, EventArgs e)
{
// Dynamically generated field pagers need to be created only
// the first time the page is loaded.
if (!IsPostBack)
{
// Create a NextPreviousPagerField object to display
// the buttons to navigate.
NextPreviousPagerField pagerField = new NextPreviousPagerField();
pagerField.ShowFirstPageButton = true;
pagerField.ShowLastPageButton = true;
pagerField.ButtonType = ButtonType.Button;
// Add the pager field to the Fields collection of the
// DataPager control.
ContactsDataPager.Fields.Add(pagerField);
}
ContactsListView.DataBind();
}
Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
' Dynamically generated field pagers need to be created only
' the first time the page is loaded.
If Not IsPostBack Then
' Create a NextPreviousPagerField object to display
' the buttons to navigate.
Dim pagerField As New NextPreviousPagerField()
pagerField.ShowFirstPageButton = True
pagerField.ShowLastPageButton = True
pagerField.ButtonType = ButtonType.Button
' Add the pager field to the Fields collection of the
' DataPager control.
ContactsDataPager.Fields.Add(pagerField)
End If
ContactsListView.DataBind()
End Sub
Keterangan
Bidang pager ditampilkan dalam DataPager kontrol dalam urutan bidang pager muncul dalam Fields koleksi. Tabel berikut ini memperlihatkan kelas bidang pager yang berasal dari DataPagerField kelas dan yang dapat digunakan dalam Fields koleksi.
Tipe bidang pager | Deskripsi |
---|---|
NextPreviousPagerField | Memungkinkan pengguna menavigasi halaman data satu halaman pada satu waktu, atau melompat ke halaman pertama atau terakhir data. |
NumericPagerField | Memungkinkan pengguna memilih halaman data menurut nomor halaman. |
TemplatePagerField | Memungkinkan Anda membuat UI halaman kustom. |
Untuk menentukan bidang DataPager pager untuk kontrol secara deklaratif, letakkan Fields
elemen di DataPager dalam kontrol. Anda kemudian dapat mencantumkan bidang pager yang ingin Anda sertakan antara tag pembuka dan penutup <Fields>
.
Anda dapat menambahkan bidang pager secara terprogram ke Fields koleksi. Namun, lebih mudah untuk mencantumkan bidang pager secara deklaratif dalam DataPager kontrol.