Edit

Share via

TextBox.OnPreRender(EventArgs) Method

  • Reference

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Registers client script for generating postback events prior to rendering on the client, if AutoPostBack is true.

C# 
protected override void OnPreRender(EventArgs e);
C# 
protected internal override void OnPreRender(EventArgs e);

Parameters

e
EventArgs

An EventArgs that contains the event data.

Examples

The following code example demonstrates how to override the OnPreRender method so that it always displays a one-point border in a custom TextBox server control.

Important

This example has a text box that accepts user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements. For more information, see Script Exploits Overview.

ASP.NET (C#) 
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ Page Language="C#" AutoEventWireup="True" %>
<!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 TextBox - OnPreRender - C# Example</title>
    </head>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom TextBox - OnPreRender - C# Example</h3>
            
            <aspSample:CustomTextBoxOnPreRender 
              id="TextBox1" 
              runat="server">Hello World!
            </aspSample:CustomTextBoxOnPreRender>
            
        </form>
    </body>
</html>
C# 
using System.Web;
using System.Security.Permissions;

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
  public sealed class CustomTextBoxOnPreRender : System.Web.UI.WebControls.TextBox
  {
    protected override void OnPreRender(System.EventArgs e)
    {
      // Run the OnPreRender method on the base class.
      base.OnPreRender(e);

      // Display the TextBox with a 1 point border.
      this.BorderWidth = System.Web.UI.WebControls.Unit.Point(1);
    }
  }
}

Applies to

Product Versions
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1