This documentation is archived and is not being maintained.

HtmlImage Class

Provides programmatic access for the HTML <img> element on the server.

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

public class HtmlImage extends HtmlControl
<asp:HtmlImage />

Use this control to display an image on a Web page. The HtmlImage control can be programmatically manipulated to change the image displayed, the image size, and the alignment of the image relative to other page elements.

For a list of initial property values for an instance of HtmlImage, see the HtmlImage constructor.

The following code example demonstrates how to programmatically modify the properties of an HtmlImage control when an HtmlButton is clicked.

<%@ Page Language="JScript" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
<html xmlns="" >
    <title>HtmlImage Example</title>
<script language="JSCRIPT" runat="server">

    function Image1_Click(sender : Object, e : EventArgs){
        Image1.Src = "Image1.jpg"
        Image1.Height = 226
        Image1.Width = 500
        Image1.Border = 5
        Image1.Align = "center"
        Image1.Alt = "Image 1"

    function Image2_Click(sender : Object, e : EventArgs){
        Image1.Src = "Image2.jpg"
        Image1.Height = 480
        Image1.Width = 640
        Image1.Border = 7
        Image1.Align = "left"
        Image1.Alt = "Image 2"

    function Image3_Click(sender : Object, e : EventArgs){
        Image1.Src = "Image3.jpg"
        Image1.Height = 413
        Image1.Width = 631
        Image1.Border = 3
        Image1.Align = "right"
        Image1.Alt = "Image 3"




    <form id="form1" runat="server">

       <h3>HtmlImage Example</h3>


          <button id="Button1"
          Image 1

          <button id="Button2"
          Image 2

          <button id="Button3"
          Image 3


       <br /><br />

       <img id ="Image1"
            alt="Image 1"
            style="width:500; height:226; border:5; text-align:center" />
       Enter the caption for this image here.



Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

.NET Framework

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