Compartilhar via

HtmlTextArea.OnPreRender(EventArgs) Método

  • Referência

Definição

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

Aciona o evento PreRender.

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)

Parâmetros

e
EventArgs

Um objeto EventArgs que contém os dados do evento.

Exemplos

O exemplo de código a seguir demonstra como substituir o OnPreRender método para sempre exibir 5 linhas e 75 colunas em um controle de servidor personalizado HtmlTextArea .

<%@ 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">
<script runat="server">
  void Page_Load(Object sender, EventArgs e)
  {

    HtmlTextArea1.Value = "Hello Html Text Area World.";

  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>Custom HtmlTextArea OnPreRender Example</title>
  </head>

  <body>
    <form id="Form1" 
          method="post" 
          runat="server">

      <h3>Custom HtmlTextArea OnPreRender Example</h3>

      <aspSample:CustomHtmlTextAreaOnPreRender 
        id="HtmlTextArea1" 
        name="HtmlTextArea1" 
        runat="server" 
        rows="4" 
        cols="50" />
        
    </form>
  </body>
</html>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ Page Language="VB" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)

    HtmlTextArea1.Value = "Hello Html Text Area World."

  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>Custom HtmlTextArea OnPreRender Example</title>
  </head>

  <body>
    <form id="Form1" 
          method="post" 
          runat="server">

      <h3>Custom HtmlTextArea OnPreRender Example</h3>

      <aspSample:CustomHtmlTextAreaOnPreRender 
        id="HtmlTextArea1" 
        name="HtmlTextArea1" 
        runat="server" 
        rows="4" 
        cols="50" />
        
    </form>
  </body>
</html>

using System.Web;
using System.Security.Permissions;

namespace Samples.AspNet.CS.Controls
{
    [AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal)]
    public sealed class CustomHtmlTextAreaOnPreRender : System.Web.UI.HtmlControls.HtmlTextArea
    {
        protected override void OnPreRender(System.EventArgs e)
        {
            // Call the base class's OnPreRender method.
            base.OnPreRender(e);
            
            // Always display this control with 5 rows and 75 columns.
            this.Rows = 5;
            this.Cols = 75;
        }
    }
}

Imports System.Web
Imports System.Security.Permissions

Namespace Samples.AspNet.VB.Controls
    <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public NotInheritable Class CustomHtmlTextAreaOnPreRender
        Inherits System.Web.UI.HtmlControls.HtmlTextArea

        Protected Overrides Sub OnPreRender(ByVal e As System.EventArgs)

            ' Call the base class's OnPreRender method.
            MyBase.OnPreRender(e)

            ' Always display this control with 5 rows and 75 columns.
            Me.Rows = 5
            Me.Cols = 75
        End Sub
    End Class
End Namespace

Comentários

O OnPreRender método notifica o controle para executar as HtmlTextArea etapas necessárias antes de salvar o estado de exibição e renderizar o conteúdo.

O OnPreRender método é usado principalmente por desenvolvedores de controle que estendem a funcionalidade do HtmlTextArea controle.

Notas aos Herdeiros

Ao substituir o OnPreRender(EventArgs) método em uma classe derivada, chame o método da OnPreRender(EventArgs) classe base para que o HtmlTextArea controle seja registrado corretamente com a página.

Aplica-se a

Confira também