PreRender イベントを発生させます。
名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文
'宣言
Protected Friend Overrides Sub OnPreRender ( _
e As EventArgs _
)
'使用
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
)
適用できません。
パラメータ
- e
イベント データを格納している EventArgs オブジェクト。
解説
OnPreRender メソッドは、ビューステートの保存やクライアントへの内容の表示の前に、必要な表示前の手順を実行するよう LinkButton コントロールに通知します。
使用例
カスタム LinkButton コントロールで境界線が表示されないように、OnPreRender メソッドをオーバーライドする方法を次のコード例に示します。
<%@ 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">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Custom LinkButton - OnPreRender - VB.NET Example</title>
<script runat="server">
Sub LinkButton1_Command(sender As Object, e As CommandEventArgs)
' Redirect to the Microsoft home page.
Response.Redirect("https://www.microsoft.com/")
End Sub
</script>
</head>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom LinkButton - OnPreRender - VB.NET Example</h3>
<aspSample:CustomLinkButtonOnPreRender id="LinkButton1"
runat="server" OnCommand="LinkButton1_Command"
ToolTip="Microsoft Home">Microsoft Corp.</aspSample:CustomLinkButtonOnPreRender>
</form>
</body>
</html>
...
<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class CustomLinkButtonOnPreRender
Inherits System.Web.UI.WebControls.LinkButton
Protected Overrides Sub OnPreRender(ByVal e As System.EventArgs)
' Run the OnPreRender method on the base class.
MyBase.OnPreRender(e)
' Always display the LinkButton without a border.
Me.BorderWidth = System.Web.UI.WebControls.Unit.Point(0)
End Sub
End Class
<%@ 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 LinkButton - OnPreRender - C# Example</title>
<script runat="server">
void LinkButton1_Command(Object sender, CommandEventArgs e)
{
// Redirect to the Microsoft home page.
Response.Redirect("https://www.microsoft.com/");
}
</script>
</head>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom LinkButton - OnPreRender - C# Example</h3>
<aspSample:CustomLinkButtonOnPreRender
id="LinkButton1"
runat="server"
OnCommand="LinkButton1_Command"
ToolTip="Microsoft Home">Microsoft Corp.
</aspSample:CustomLinkButtonOnPreRender>
</form>
</body>
</html>
...
using System.Web;
using System.Security.Permissions;
namespace Samples.AspNet.CS.Controls
{
[AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
public sealed class CustomLinkButtonOnPreRender : System.Web.UI.WebControls.LinkButton
{
protected override void OnPreRender(System.EventArgs e)
{
// Run the OnPreRender method on the base class.
base.OnPreRender(e);
// Always display the LinkButton without a border.
this.BorderWidth = System.Web.UI.WebControls.Unit.Point(0);
}
}
}
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.JSL.Controls" Assembly="Samples.AspNet.JSL" %>
<%@ Page Language="VJ#" 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 LinkButton - OnPreRender - VJ# Example</title>
<script runat="server">
void LinkButton1_Command(Object sender, CommandEventArgs e)
{
// Redirect to the Microsoft home page.
get_Response().Redirect("https://www.microsoft.com/");
} //LinkButton1_Command
</script>
</head>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom LinkButton - OnPreRender - VJ# Example</h3>
<aspSample:CustomLinkButtonOnPreRender
id="LinkButton1"
runat="server"
OnCommand="LinkButton1_Command"
ToolTip="Microsoft Home">Microsoft Corp.
</aspSample:CustomLinkButtonOnPreRender>
</form>
</body>
</html>
...
package Samples.AspNet.JSL.Controls;
public class CustomLinkButtonOnPreRender
extends System.Web.UI.WebControls.LinkButton
{
protected void OnPreRender(System.EventArgs e)
{
// Run the OnPreRender method on the base class.
super.OnPreRender(e);
// Always display the LinkButton without a border.
this.set_BorderWidth(System.Web.UI.WebControls.Unit.Point(0));
} //OnPreRender
} //CustomLinkButtonOnPreRender
プラットフォーム
Windows 98,Windows Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition
Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。
バージョン情報
.NET Framework
サポート対象 : 3.0,2.0,1.1,1.0
参照
関連項目
LinkButton クラス
LinkButton メンバ
System.Web.UI.WebControls 名前空間
PreRender