指定した HtmlTextWriter オブジェクトに、TextBox コントロールをレンダリングします。
名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文
'宣言
Protected Friend Overrides Sub Render ( _
writer As HtmlTextWriter _
)
'使用
Dim writer As HtmlTextWriter
Me.Render(writer)
protected internal override void Render (
HtmlTextWriter writer
)
protected public:
virtual void Render (
HtmlTextWriter^ writer
) override
protected void Render (
HtmlTextWriter writer
)
protected internal override function Render (
writer : HtmlTextWriter
)
適用できません。
パラメータ
- writer
表示される出力を受け取る HtmlTextWriter。
解説
Render メソッドは、クライアント側での出力で HtmlTextWriter オブジェクトに TextBox コントロールの開始タグと終了タグを表示します。TextMode プロパティを MultiLine に設定すると、TextBox コントロールの内容が HTML <textarea> 要素として表示されます。
Render メソッドは、主に、コントロール開発者が TextBox コントロールの機能を拡張する際に使用します。
使用例
カスタム サーバー コントロールの Render メソッドをオーバーライドして、TextBox コントロールを常にイメージ付きで表示する方法を次のコード例に示します。
.gif) セキュリティに関するメモ : |
|---|
この例には、ユーザー入力を受け付けるテキスト ボックスがあります。これにより、セキュリティが脆弱になる可能性があります。既定では、ASP.NET Web ページによって、ユーザー入力にスクリプトまたは 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">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Custom TextBox - Render - VB.NET Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom TextBox - Render - VB.NET Example</h3>
<aspSample:CustomTextBoxRender id="TextBox1"
runat="server">Hello World!</aspSample:CustomTextBoxRender>
</form>
</body>
</html>
<%@ 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 - Render - C# Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom TextBox - Render - C# Example</h3>
<aspSample:CustomTextBoxRender
id="TextBox1"
runat="server">Hello World!
</aspSample:CustomTextBoxRender>
</form>
</body>
</html>
<%@ 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 TextBox - Render - VJ# Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom TextBox - Render - VJ# Example</h3>
<aspSample:CustomTextBoxRender
id="TextBox1"
runat="server"
text="Hello World!">
</aspSample:CustomTextBoxRender>
</form>
</body>
</html>
Imports System.Web
Imports System.Security.Permissions
Namespace Samples.AspNet.VB.Controls
<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class CustomTextBoxRender
Inherits System.Web.UI.WebControls.TextBox
Protected Overrides Sub Render(ByVal writer As System.Web.UI.HtmlTextWriter)
' Create and render a new Image Web control.
Dim image As New System.Web.UI.WebControls.Image
image.ID = "Image1"
image.ImageUrl = "image.jpg"
image.AlternateText = "Image for TextBox1."
image.RenderControl(writer)
' Create a BR tag.
writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Br)
' Call the base class's Render method.
MyBase.Render(writer)
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 CustomTextBoxRender : System.Web.UI.WebControls.TextBox
{
protected override void Render(System.Web.UI.HtmlTextWriter writer)
{
// Create and render a new Image Web control.
System.Web.UI.WebControls.Image image = new System.Web.UI.WebControls.Image();
image.ID = "Image1";
image.ImageUrl = "image.jpg";
image.AlternateText = "Image for TextBox1.";
image.RenderControl(writer);
// Create a BR tag.
writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Br);
// Call the base class's Render method.
base.Render(writer);
}
}
}
package Samples.AspNet.JSL.Controls;
public class CustomTextBoxRender
extends System.Web.UI.WebControls.TextBox
{
protected void Render(System.Web.UI.HtmlTextWriter writer)
{
// Create and render a new Image Web control.
System.Web.UI.WebControls.Image image = new System.Web.UI.
WebControls.Image();
image.set_ID("Image1");
image.set_ImageUrl("image.jpg");
image.set_AlternateText("Image for TextBox1.");
image.RenderControl(writer);
// Create a BR tag.
writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Br);
// Call the base class's Render method.
super.Render(writer);
} //Render
} //CustomTextBoxRender
プラットフォーム
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
参照
関連項目
TextBox クラス
TextBox メンバ
System.Web.UI.WebControls 名前空間
TextMode
RenderBeginTag
RenderEndTag