RadioButtonList.Render(HtmlTextWriter) メソッド

定義

名前空間:
System.Web.UI.WebControls
アセンブリ:
System.Web.dll

クライアントの RadioButtonList コントロールを表示します。

protected:
 override void Render(System::Web::UI::HtmlTextWriter ^ writer);
protected public:
 override void Render(System::Web::UI::HtmlTextWriter ^ writer);
protected override void Render(System.Web.UI.HtmlTextWriter writer);
protected internal override void Render(System.Web.UI.HtmlTextWriter writer);
override this.Render : System.Web.UI.HtmlTextWriter -> unit
Protected Overrides Sub Render (writer As HtmlTextWriter)
Protected Friend Overrides Sub Render (writer As HtmlTextWriter)

パラメーター

writer
HtmlTextWriter

クライアントでレンダリングするための出力ストリームを含む HtmlTextWriter 。

例

次のコード例では、カスタム サーバー コントロールの Render メソッドをオーバーライドして、 RadioButtonList コントロールが常に説明テキストで表示されるようにする方法を示します。

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<!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 RadioButtonList - Render - C# Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">
      <h3>Custom RadioButtonList - Render - C# Example</h3>

      <aspSample:CustomRadioButtonListRender 
        id="Radiobuttonlist1" 
        runat="server" 
        RepeatColumns="2" 
        RepeatDirection="Horizontal">
        <asp:ListItem Value="Item1">Item1</asp:ListItem>
        <asp:ListItem Value="Item2">Item2</asp:ListItem>
        <asp:ListItem Value="Item3">Item3</asp:ListItem>
        <asp:ListItem Value="Item4">Item4</asp:ListItem>
      </aspSample:CustomRadioButtonListRender>
      
    </form>
  </body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.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 RadioButtonList - Render - VB.NET Example</title>
    </head>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom RadioButtonList - Render - VB.NET Example</h3>

            <aspSample:CustomRadioButtonListRender
             id="Radiobuttonlist1" runat="server" 
             RepeatColumns="2" RepeatDirection="Horizontal">
                <asp:ListItem Value="Item1">Item1</asp:ListItem>
                <asp:ListItem Value="Item2">Item2</asp:ListItem>
                <asp:ListItem Value="Item3">Item3</asp:ListItem>
                <asp:ListItem Value="Item4">Item4</asp:ListItem>
            </aspSample:CustomRadioButtonListRender>
        </form>
    </body>
</html>

using System.Web;
using System.Security.Permissions;

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
  public sealed class CustomRadioButtonListRender : System.Web.UI.WebControls.RadioButtonList
  {
    protected override void Render(System.Web.UI.HtmlTextWriter writer)
    {
      // Call the base RenderContents method.
      base.Render(writer);

      // Append some text to the Image.
      writer.Write("Experience Windows Server 2003 and Visual Studio® .NET 2003.");
    }
  }
}

Imports System.Web
Imports System.Security.Permissions

Namespace Samples.AspNet.VB.Controls
    <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public NotInheritable Class CustomRadioButtonListRender
        Inherits System.Web.UI.WebControls.RadioButtonList

        Protected Overrides Sub Render(ByVal writer As System.Web.UI.HtmlTextWriter)

            ' Call the base RenderContents method.
            MyBase.Render(writer)

            ' Append some text to the Image.
            writer.Write("Experience Windows Server 2003 and Visual Studio .NET 2003.")
        End Sub
    End Class
End Namespace

注釈

このメソッドは、主に、 RadioButtonList クラスから派生するカスタム コントロールのコントロール開発者によって使用されます。

Render コントロールの RadioButtonList メソッドの実装は、リストのRepeatInfo オブジェクトを初期化し、RenderRepeater メソッドを呼び出します。このメソッドは、RenderItem メソッドを使用して個々のラジオ ボタンリスト項目をレンダリングします。

適用対象

こちらもご覧ください