CheckBoxList.OnPreRender(EventArgs) Metode
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.
CheckBoxList Mengonfigurasi kontrol sebelum merender pada klien.
protected:
override void OnPreRender(EventArgs ^ e);
protected public:
override void OnPreRender(EventArgs ^ e);
protected override void OnPreRender (EventArgs e);
protected internal override void OnPreRender (EventArgs e);
override this.OnPreRender : EventArgs -> unit
Protected Overrides Sub OnPreRender (e As EventArgs)
Protected Friend Overrides Sub OnPreRender (e As EventArgs)
Parameter
Contoh
Contoh kode berikut menunjukkan cara mengambil alih CreateControlStyle metode dalam kontrol server kustom sehingga selalu mengembalikan instans TableStyle baru kelas untuk CheckBoxList.
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ 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>
<title>Custom CheckBoxList - OnPreRender - C# Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom CheckBoxList - OnPreRender - C# Example</h3>
<aspSample:CustomCheckBoxListOnPreRender
id="CheckBoxList1" runat="server">
<asp:ListItem Selected="True">Item 1</asp:ListItem>
<asp:ListItem>Item 2</asp:ListItem>
<asp:ListItem>Item 3</asp:ListItem>
<asp:ListItem>Item 4</asp:ListItem>
<asp:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</aspSample:CustomCheckBoxListOnPreRender>
</form>
</body>
</html>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ 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>
<title>Custom CheckBoxList - OnPreRender - VB.NET Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom CheckBoxList - OnPreRender - VB.NET Example</h3>
<aspSample:CustomCheckBoxListOnPreRender id="CheckBoxList" runat="server"
RepeatLayout="Table" RepeatColumns="2" CellSpacing="3" CellPadding="3">
<asp:ListItem Selected="True">Item 1</asp:ListItem>
<asp:ListItem>Item 2</asp:ListItem>
<asp:ListItem>Item 3</asp:ListItem>
<asp:ListItem>Item 4</asp:ListItem>
<asp:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</aspSample:CustomCheckBoxListOnPreRender>
</form>
</body>
</html>
using System;
using System.Web;
using System.Web.UI.WebControls;
using System.Security.Permissions;
namespace Samples.AspNet.CS.Controls
{
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
public class CustomCheckBoxListOnPreRender : CheckBoxList
{
protected override void OnPreRender(EventArgs e)
{
// Run the OnPreRender method on the base class.
base.OnPreRender(e);
// Display the Calendar with a 3 point border.
this.BorderWidth = Unit.Point(3);
}
}
}
Imports System.Web
IMports System.Web.UI.WebControls
Imports System.Security.Permissions
Namespace Samples.AspNet.VB.Controls
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
Public Class CustomCheckBoxListOnPreRender
Inherits System.Web.UI.WebControls.CheckBoxList
Protected Overrides Sub OnPreRender(ByVal e As EventArgs)
' Run the OnPreRender method on the base class.
MyBase.OnPreRender(e)
' Display the CheckBoxList with a 3 point border.
Me.BorderWidth = Unit.Point(3)
End Sub
End Class
End Namespace
Keterangan
Metode OnPreRender ini digunakan terutama oleh pengembang kontrol dalam kontrol kustom yang berasal dari CheckBoxList kelas . Metode ini OnPreRender memungkinkan kelas turunan untuk menangani PreRender peristiwa tanpa melampirkan delegasi. Ini adalah teknik yang disukai untuk menangani peristiwa di kelas turunan.
Metode ini OnPreRender melakukan langkah-langkah pra-penyajian yang diperlukan sebelum menyimpan status tampilan dan merender konten untuk CheckBoxList. Item daftar individual yang terkandung dalam kontrol diinisialisasi CheckBoxList untuk penyajian menggunakan nilai , , CausesValidationdan ValidationGroup saat iniAutoPostBack.
Catatan Bagi Inheritor
Saat mengambil alih di kelas turunan OnPreRender(EventArgs) , pastikan untuk memanggil metode kelas OnPreRender(EventArgs) dasar sehingga delegasi terdaftar menerima peristiwa tersebut.