HtmlTextArea.OnPreRender(EventArgs) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
引發 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)
參數
範例
下列程式碼範例示範如何覆寫 OnPreRender 方法,以一律在自訂 HtmlTextArea 伺服器控制項中顯示 5 個數據列和 75 個數據行。
<%@ 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
備註
方法 OnPreRender 會在 HtmlTextArea 儲存檢視狀態和轉譯內容之前通知控制項執行任何必要步驟。
方法 OnPreRender 主要是由控制項開發人員使用,以擴充控制項的功能 HtmlTextArea 。
給繼承者的注意事項
在衍生類別中覆 OnPreRender(EventArgs) 寫 方法時,請務必呼叫基類 OnPreRender(EventArgs) 的 方法,讓 HtmlTextArea 控制項正確地向頁面註冊。