CheckBoxList.Render メソッド
クライアントに CheckBoxList を表示します。
名前空間: 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
クライアントに表示する出力ストリームが格納されている System.Web.UI.HtmlTextWriter。
解説
Render メソッドは、カスタム コントロールを CheckBoxList クラスから派生させる場合に、主にコントロールの開発者によって使用されます。
CheckBoxList コントロールの Render 実装はリストの RepeatInfo オブジェクトを初期化し、RenderRepeater メソッドを呼び出します。次にこのメソッドが RenderItem メソッドを使用して、チェック ボックスの各リスト項目を表示します。
使用例
カスタム サーバー コントロールの Render メソッドをオーバーライドして、常に CheckBoxList にイメージを表示する方法のコード例を次に示します。
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ Page language="VB" %>
<!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 CheckBoxList - Render - VB.NET Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom CheckBoxList - Render - VB.NET Example</h3>
<aspSample:CustomCheckBoxListRender id="CheckBoxList" runat="server"
RepeatLayout="Table" RepeatColumns="2" CellSpacing="3" CellPadding="3">
<asp:ListItem Selected="True">Item 1</asp:ListItem>
<asp:ListItem>Item 2</asp:ListItem>
<asp:ListItem>Item 3</asp:ListItem>
<asp:ListItem>Item 4</asp:ListItem>
<asp:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</aspSample:CustomCheckBoxListRender>
</form>
</body>
</html>
...
Imports System.Web
Imports System.Security.Permissions
Namespace Samples.AspNet.VB.Controls
<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class CustomCheckBoxListRender
Inherits System.Web.UI.WebControls.CheckBoxList
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 CheckBoxList1."
image.RenderControl(writer)
' Call the base class's Render method.
MyBase.Render(writer)
End Sub
End Class
End Namespace
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ Page language="c#" %>
<!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 CheckBoxList - Render - C# Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom CheckBoxList - Render - C# Example</h3>
<aspSample:CustomCheckBoxListRender
id="CheckBoxList1" runat="server">
<asp:ListItem Selected="True">Item 1</asp:ListItem>
<asp:ListItem>Item 2</asp:ListItem>
<asp:ListItem>Item 3</asp:ListItem>
<asp:ListItem>Item 4</asp:ListItem>
<asp:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</aspSample:CustomCheckBoxListRender>
</form>
</body>
</html>
...
using System.Web;
using System.Security.Permissions;
namespace Samples.AspNet.CS.Controls
{
[AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal)]
public sealed class CustomCheckBoxListRender : System.Web.UI.WebControls.CheckBoxList
{
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 CheckBoxList1.";
image.RenderControl(writer);
// Call the base class's Render method.
base.Render(writer);
}
}
}
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.JSL.Controls" Assembly="Samples.AspNet.JSL" %>
<%@ Page language="VJ#" %>
<!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 CheckBoxList - Render - VJ# Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom CheckBoxList - Render - VJ# Example</h3>
<aspSample:CustomCheckBoxListRender
id="CheckBoxList1" runat="server">
<asp:ListItem Selected="True">Item 1</asp:ListItem>
<asp:ListItem>Item 2</asp:ListItem>
<asp:ListItem>Item 3</asp:ListItem>
<asp:ListItem>Item 4</asp:ListItem>
<asp:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</aspSample:CustomCheckBoxListRender>
</form>
</body>
</html>
...
package Samples.AspNet.JSL.Controls;
public class CustomCheckBoxListRender
extends System.Web.UI.WebControls.CheckBoxList
{
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 CheckBoxList1.");
image.RenderControl(writer);
// Call the base class's Render method.
super.Render(writer);
} //Render
} //CustomCheckBoxListRender
プラットフォーム
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
参照
関連項目
CheckBoxList クラス
CheckBoxList メンバ
System.Web.UI.WebControls 名前空間