Image.RenderContents Method
Renders the image control contents to the specified writer.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)
Parameters
- 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" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" > <head> <title>Custom Image - RenderContents - C# Example</title> </head> <body> <form id="Form1" method="post" runat="server"> <h3>Custom Image - RenderContents - C# Example</h3> <aspSample:CustomImageRenderContents id="Image1" runat="server" ImageUrl="http://www.microsoft.com/homepage/gif/bnr-microsoft.gif" AlternateText="Microsoft Home" /> </form> </body> </html> ... 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. base.RenderContents(writer); // Append some text to the Image. writer.Write("<BR>Experience Windows Server 2003 and Visual Studio� .NET 2003."); } } }
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
