RenderContents Method

Image.RenderContents Method (HtmlTextWriter)


Renders the image control contents to the specified writer.

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

protected internal override void RenderContents(
	HtmlTextWriter writer


Type: System.Web.UI.HtmlTextWriter

An HtmlTextWriter that represents the output stream to render HTML content on the client.

The RenderContents method is primarily used by control developers. The Image control implements the RenderContents method to skip rendering of any child controls.

The following code example demonstrates how to override the RenderContents method in a custom server control so that some text is always displayed after the Image.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
<html xmlns="" >
        <title>Custom Image - RenderContents - C# Example</title>
        <form id="Form1" method="post" runat="server">
            <h3>Custom Image - RenderContents - C# Example</h3>

              AlternateText="Microsoft Home" />

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

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

      // Append some text to the Image.
      writer.Write("<BR>Experience Windows Server 2003 and Visual Studio� .NET 2003.");

.NET Framework
Available since 1.1
Return to top
© 2015 Microsoft