RadioButtonList.Render Method (HtmlTextWriter)

 

Displays the RadioButtonList control on the client.

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

protected internal override void Render(
	HtmlTextWriter writer
)

Parameters

writer
Type: System.Web.UI.HtmlTextWriter

A System.Web.UI.HtmlTextWriter that contains the output stream for rendering on the client.

This method is used primarily by control developers in custom controls that derive from the RadioButtonList class.

The Render method implementation for a RadioButtonList control initializes a RepeatInfo object for the list, and calls the RenderRepeater method, which in turn uses the RenderItem method to render individual radio button list items.

The following code example demonstrates how to override the Render method in a custom server control so that the RadioButtonList control is always displayed with descriptive text.

<%@ 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>
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.");
    }
  }
}

.NET Framework
Available since 1.1
Return to top
Show: