DetailsView.HeaderRow 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.
DetailsViewRow Mendapatkan objek yang mewakili baris header dalam DetailsView kontrol.
public:
virtual property System::Web::UI::WebControls::DetailsViewRow ^ HeaderRow { System::Web::UI::WebControls::DetailsViewRow ^ get(); };[System.ComponentModel.Browsable(false)]
public virtual System.Web.UI.WebControls.DetailsViewRow HeaderRow { get; }[<System.ComponentModel.Browsable(false)>]
member this.HeaderRow : System.Web.UI.WebControls.DetailsViewRowPublic Overridable ReadOnly Property HeaderRow As DetailsViewRowNilai Properti
DetailsViewRow yang mewakili baris header dalam DetailsView kontrol.
- Atribut
Contoh
Contoh kode berikut menunjukkan cara menggunakan HeaderRow properti untuk mengakses baris DetailsView header kontrol selama ItemCreated peristiwa. Kontrol Label dalam baris header kustom kemudian diperbarui dengan nomor halaman saat ini.
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void CustomerDetailView_ItemCreated(Object sender, EventArgs e)
{
// Get the header row.
DetailsViewRow headerRow = CustomerDetailView.HeaderRow;
// Get the Label control that displays the current page information
// from the header row.
Label pageNum = (Label)headerRow.FindControl("PageNumberLabel");
if(pageNum != null)
{
// Update the Label control with the current page number.
int page = CustomerDetailView.DataItemIndex + 1;
pageNum.Text = "Page " + page.ToString ();
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>DetailsView HeaderTemplate Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>DetailsView HeaderTemplate Example</h3>
<asp:detailsview id="CustomerDetailView"
datasourceid="DetailsViewSource"
datakeynames="CustomerID"
autogeneraterows="true"
allowpaging="true"
onitemcreated="CustomerDetailView_ItemCreated"
runat="server">
<headerstyle backcolor="Navy"
forecolor="White"/>
<pagersettings Mode="NextPreviousFirstLast"/>
<headertemplate>
<table width="100%">
<tr>
<td align="left">
<asp:Image id="LogoImage"
imageurl="~\images\Logo.jpg"
AlternateText="Our logo"
runat="server"/>
</td>
<td align="right" valign="bottom">
<asp:Label id="PageNumberLabel"
font-size="9"
forecolor="DodgerBlue"
runat="server"/>
</td>
</tr>
</table>
</headertemplate>
</asp:detailsview>
<!-- 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="DetailsViewSource" runat="server"
ConnectionString=
"<%$ ConnectionStrings:NorthWindConnectionString%>"
InsertCommand="INSERT INTO [Customers]([CustomerID],
[CompanyName], [Address], [City], [PostalCode], [Country])
VALUES (@CustomerID, @CompanyName, @Address, @City,
@PostalCode, @Country)"
SelectCommand="Select [CustomerID], [CompanyName],
[Address], [City], [PostalCode], [Country] From
[Customers]">
</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">
<script runat="server">
Sub CustomerDetailView_ItemCreated(ByVal sender As Object, _
ByVal e As EventArgs)
' Get the header row.
Dim headerRow As DetailsViewRow = CustomerDetailView.HeaderRow
' Get the Label control that displays the current page information
' from the header row.
Dim pageNum As Label = _
CType(headerRow.FindControl("PageNumberLabel"), Label)
If Not pageNum Is Nothing Then
' Update the Label control with the current page number.
Dim page As Integer = CustomerDetailView.DataItemIndex + 1
pageNum.Text = "Page " & page.ToString()
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>DetailsView HeaderTemplate Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>DetailsView HeaderTemplate Example</h3>
<asp:detailsview id="CustomerDetailView"
datasourceid="DetailsViewSource"
datakeynames="CustomerID"
autogeneraterows="true"
allowpaging="true"
onitemcreated="CustomerDetailView_ItemCreated"
runat="server">
<headerstyle backcolor="Navy"
forecolor="White"/>
<pagersettings Mode="NextPreviousFirstLast"/>
<headertemplate>
<table width="100%">
<tr>
<td align="left">
<asp:Image id="LogoImage"
imageurl="~\images\Logo.jpg"
AlternateText="Our logo"
runat="server"/>
</td>
<td align="right" valign="bottom">
<asp:Label id="PageNumberLabel"
font-size="9"
forecolor="DodgerBlue"
runat="server"/>
</td>
</tr>
</table>
</headertemplate>
</asp:detailsview>
<!-- 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="DetailsViewSource" runat="server"
ConnectionString=
"<%$ ConnectionStrings:NorthWindConnectionString%>"
InsertCommand="INSERT INTO [Customers]([CustomerID],
[CompanyName], [Address], [City], [PostalCode], [Country])
VALUES (@CustomerID, @CompanyName, @Address, @City,
@PostalCode, @Country)"
SelectCommand="Select [CustomerID], [CompanyName],
[Address], [City], [PostalCode], [Country] From
[Customers]">
</asp:SqlDataSource>
</form>
</body>
</html>
Keterangan
Baris header ditampilkan di bagian DetailsView atas kontrol saat HeaderText properti atau HeaderTemplate diatur. HeaderRow Gunakan properti untuk mengakses DetailsViewRow objek yang mewakili baris header secara terprogram.
Catatan
Properti HeaderRow hanya tersedia setelah DetailsView kontrol membuat baris header dalam peristiwa tersebut ItemCreated .
Properti ini biasanya digunakan ketika Anda perlu memanipulasi baris header secara terprogram, misalnya saat menambahkan konten kustom. Setiap modifikasi pada HeaderRow properti harus dilakukan setelah DetailsView kontrol dirender; jika tidak, DetailsView kontrol akan menimpa perubahan apa pun.
