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)

<AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
Public Class HtmlImage _
	Inherits HtmlControl
Dim instance As HtmlImage
<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="VB" AutoEventWireup="True" %>

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

    Sub Image1_Click(sender As Object, e As EventArgs)
        Image1.Src = "Image1.jpg"
        Image1.Height = 226
        Image1.Width = 500
        Image1.Border = 5
        Image1.Align = "center"
        Image1.Alt = "Image 1" 
    End Sub 'Image1_Click

    Sub Image2_Click(sender As Object, e As EventArgs)
        Image1.Src = "Image2.jpg"
        Image1.Height = 480
        Image1.Width = 640
        Image1.Border = 7
        Image1.Align = "left"
        Image1.Alt = "Image 2" 
    End Sub 'Image2_Click

    Sub Image3_Click(sender As Object, e As EventArgs)
        Image1.Src = "Image3.jpg"
        Image1.Height = 413
        Image1.Width = 631
        Image1.Border = 3
        Image1.Align = "right"
        Image1.Alt = "Image 3" 
    End Sub 'Image3_Click




    <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