CheckBox.Render Method (HtmlTextWriter)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

This API supports the product infrastructure and is not intended to be used directly from your code.

Displays the CheckBox 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 to render on the client.

<%@ 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 CheckBox - Render - C# Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">
      <h3>Custom CheckBox - Render - C# Example</h3>

      <aspSample:CustomCheckBoxRender
        id="CheckBox1"
        runat="server"
        text="CheckBox1" />

    </form>
  </body>
</html>
using System.Web;
using System.Security.Permissions;

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

        // Render a BR HTML tag
        writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Br);

        // 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 CheckBox1.";
        image.RenderControl(writer);
        }
    }
}

.NET Framework
Available since 1.1
Return to top
Show: