CheckBoxList.OnPreRender-Methode
Konfiguriert das CheckBoxList-Steuerelement vor der Wiedergabe auf dem Client.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Protected Friend Overrides Sub OnPreRender ( _
e As EventArgs _
)
'Usage
Dim e As EventArgs
Me.OnPreRender(e)
protected internal override void OnPreRender (
EventArgs e
)
protected public:
virtual void OnPreRender (
EventArgs^ e
) override
protected void OnPreRender (
EventArgs e
)
protected internal override function OnPreRender (
e : EventArgs
)
Parameter
- e
Eine Instanz der EventArgs-Klasse, die die Ereignisdaten enthält.
Hinweise
Die OnPreRender-Methode wird primär von Steuerelemententwicklern beim Ableiten eines benutzerdefinierten Steuerelements von der CheckBoxList-Klasse verwendet. Die OnPreRender-Methode ermöglicht es abgeleiteten Klassen, das PreRender-Ereignis ohne Anfügen eines Delegaten zu behandeln. Dies ist das bevorzugte Verfahren für die Behandlung des Ereignisses in einer abgeleiteten Klasse.
Die OnPreRender-Methode führt vor dem Speichern des Ansichtszustands und der Wiedergabe des Inhalts für die CheckBoxList alle Schritte aus, die vor der Wiedergabe erforderlich sind. Die in dem CheckBoxList-Steuerelement enthaltenen einzelnen Listenelemente werden für die Wiedergabe mithilfe der aktuellen Werte von AutoPostBack, CausesValidation und ValidationGroup initialisiert.
Hinweise für Erben Wenn Sie OnPreRender in einer abgeleiteten Klasse überschreiben, müssen Sie die OnPreRender-Methode der Basisklasse aufrufen, sodass registrierte Delegaten das Ereignis empfangen.
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie die CreateControlStyle-Methode in einem benutzerdefinierten Serversteuerelement überschrieben wird, sodass immer eine neue Instanz der TableStyle-Klasse für die CheckBoxList zurückgegeben wird.
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ Page language="VB" %>
<HTML>
<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>
...
Imports System
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
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ Page language="c#" %>
<HTML>
<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>
...
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);
}
}
}
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.JSL.Controls" Assembly="Samples.AspNet.JSL" %>
<%@ Page language="VJ#" %>
<HTML>
<HEAD>
<title>Custom CheckBoxList - OnPreRender - VJ# Example</title>
</HEAD>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom CheckBoxList - OnPreRender - VJ# 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>
...
package Samples.AspNet.JSL.Controls;
public class CustomCheckBoxListOnPreRender
extends System.Web.UI.WebControls.CheckBoxList
{
protected void OnPreRender(System.EventArgs e)
{
// Run the OnPreRender method on the base class.
super.OnPreRender(e);
// Display the Calendar with a 3 point border.
this.set_BorderWidth(System.Web.UI.WebControls.Unit.Point(3));
} //OnPreRender
} //CustomCheckBoxListOnPreRender
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
CheckBoxList-Klasse
CheckBoxList-Member
System.Web.UI.WebControls-Namespace