This topic has not yet been rated - Rate this topic

RadioButtonList.Render Method

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

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ