Cette documentation est archivée et n’est pas conservée.

CheckBoxList.OnPreRender, méthode

Configure le contrôle CheckBoxList avant l'affichage sur le client.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

protected internal override void OnPreRender (
	EventArgs e
)
protected void OnPreRender (
	EventArgs e
)
protected internal override function OnPreRender (
	e : EventArgs
)

Paramètres

e

EventArgs qui contient les données de l'événement.

La méthode OnPreRender est surtout utilisée par les développeurs de contrôles lors de la dérivation d'un contrôle personnalisé de la classe CheckBoxList. La méthode OnPreRender autorise les classes dérivées à gérer l'événement PreRender sans y attacher de délégué. C'est la méthode recommandée pour gérer l'événement dans une classe dérivée.

La méthode OnPreRender effectue toutes les étapes de pré-rendu nécessaires avant d'enregistrer l'état d'affichage et le contenu du rendu du CheckBoxList. Les éléments de liste contenus dans le contrôle CheckBoxList sont initialisés pour l'affichage à l'aide des valeurs AutoPostBack, CausesValidation et ValidationGroup actuelles.

Remarques à l'attention des héritiers Lors de la substitution de OnPreRender dans une classe dérivée, veillez à appeler la méthode OnPreRender de la classe de base de manière à ce que les délégués inscrits reçoivent l'événement.

L'exemple de code suivant montre comment substituer la méthode CreateControlStyle d'un contrôle serveur personnalisé de sorte qu'elle retourne toujours une nouvelle instance de la classe TableStyle pour CheckBoxList.

<%@ 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

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0
Afficher: