HtmlInputImage.RenderAttributes Method

Renders the HtmlInputImage control's attributes to the specified HtmlTextWriter object.

Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)

protected:
virtual void RenderAttributes (
	HtmlTextWriter^ writer
) override
protected void RenderAttributes (
	HtmlTextWriter writer
)
protected override function RenderAttributes (
	writer : HtmlTextWriter
)

Parameters

writer

The HtmlTextWriter that contains the output stream to render on the client.

Exception typeCondition

HttpException

The Src property contains a malformed URL.

The RenderAttributes method resolves the URL set in the Src property, writes the onclick attribute of the rendered HtmlInputImage control if the CausesValidation property is true, and finally calls the base RenderAttributes method. If the value of the Src property is a malformed URL, an HttpException exception is thrown.

The RenderAttributes method is used primarily by control developers extending the functionality of the HtmlInputImage control.

The following code example demonstrates how to override the RenderAttributes method in a custom server control so that specific alternate text, accessible as a ToolTip, is always displayed with the HtmlInputImage.

No code example is currently available or this language may not be supported.
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.JSL.Controls" Assembly="Samples.AspNet.JSL" %>
<%@ Page Language="VJ#" AutoEventWireup="True" %>
<HTML>
	<HEAD>
		<title>Custom HtmlInputImage - RenderAttributes - VJ# Example</title>
    <script runat="server">
    void Page_Load(Object sender, EventArgs e) 
    {
        HtmlInputImage1.get_Attributes().Add("onclick",
            "alert('Hello client-side world.');");
    } //Page_Load

    void HtmlInputImage1_ServerClick(Object sender, ImageClickEventArgs e) 
    {
        Div1.set_InnerHtml("Hello server-side world.");
    } //HtmlInputImage1_ServerClick
    </script>
	</HEAD>
	<body>
		<form id="Form1" method="post" runat="server">
			<h3>Custom HtmlInputImage - RenderAttributes - VJ# Example</h3>
		
		  <aspSample:CustomHtmlInputImageRenderAttributes 
		    id="HtmlInputImage1" 
		    name="HtmlInputImage1"
		    runat="server" 
		    type="image" 
        src="http://www.microsoft.com/homepage/gif/bnr-microsoft.gif"
        alt="Microsoft"
        onserverclick="HtmlInputImage1_ServerClick" /><br>
     
      <p><DIV 
        id="Div1" 
        runat="server" 
        style="DISPLAY: inline; WIDTH: 256px; HEIGHT: 15px" 
        ms_positioning="FlowLayout" /></p>
        
		</form>
	</body>
</HTML>

No code example is currently available or this language may not be supported.
package Samples.AspNet.JSL.Controls;

public class CustomHtmlInputImageRenderAttributes
    extends System.Web.UI.HtmlControls.HtmlInputImage
{
    protected void RenderAttributes(System.Web.UI.HtmlTextWriter writer)
    {
        // Add an ALT attribute to the the HtmlInputImage control.
        writer.Write(" alt='Microsoft'");
        // Call the base's RenderAttributes method.
        super.RenderAttributes(writer);
    } //RenderAttributes
} //CustomHtmlInputImageRenderAttributes

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

Community Additions

ADD
Show: