HtmlTextArea.OnPreRender-Methode

Löst das PreRender-Ereignis aus.

Namespace: System.Web.UI.HtmlControls
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
Ein EventArgs-Objekt, das die Ereignisdaten enthält.

Hinweise

Die OnPreRender-Methode weist das HtmlTextArea-Steuerelement an, alle erforderlichen Schritte auszuführen, bevor der Ansichtszustand gespeichert und der Inhalt gerendert wird.

Die OnPreRender-Methode wird hauptsächlich von Entwicklern von Steuerelementen zum Erweitern der Funktionalität des HtmlTextArea-Steuerelements verwendet.

Hinweise für Erben Wenn Sie die OnPreRender-Methode in einer abgeleiteten Klasse überschreiben, müssen Sie die OnPreRender-Methode der Basisklasse aufrufen, damit das HtmlTextArea-Steuerelement korrekt mit der Seite registriert wird.

Beispiel

Im folgenden Codebeispiel wird das Überschreiben der OnPreRender-Methode veranschaulicht, damit in einem benutzerdefinierten HtmlTextArea-Serversteuerelement immer 5 Zeilen und 75 Spalten angezeigt werden.

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

<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>
  <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.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ Page Language="C#" AutoEventWireup="True" %>

<script runat="server">
  void Page_Load(Object sender, EventArgs e)
  {

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

  }
</script>

<html>
  <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.JSL.Controls" Assembly="Samples.AspNet.JSL" %>
<%@ Page Language="VJ#" AutoEventWireup="True" %>
<HTML>
    <HEAD>
        <title>Custom HtmlTextArea - OnPreRender - VJ# Example</title>
    <script runat="server">
    void Page_Load(Object sender, EventArgs e) 
    {
        HtmlTextArea1.set_Value("Hello Html Text Area World.");
    } //Page_Load
    </script>
    </HEAD>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom HtmlTextArea - OnPreRender - VJ# Example</h3>

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

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

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;
        }
    }
}

package Samples.AspNet.JSL.Controls;

public class CustomHtmlTextAreaOnPreRender
    extends System.Web.UI.HtmlControls.HtmlTextArea
{
    protected void OnPreRender(System.EventArgs e)
    {
        // Call the base's OnPreRender method.
        super.OnPreRender(e);
        // Always display this control with 5 rows and 75 columns
        this.set_Rows(5);
        this.set_Cols(75);
    } //OnPreRender
} //CustomHtmlTextAreaOnPreRender

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

HtmlTextArea-Klasse
HtmlTextArea-Member
System.Web.UI.HtmlControls-Namespace
Control.PreRender
System.EventArgs

Weitere Ressourcen

HTML-Serversteuerelemente

Last updated on 2007-08-20

Freigeben über