This documentation is archived and is not being maintained.

HtmlImage Class

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

For a list of all members of this type, see HtmlImage Members.

System.Object
   System.Web.UI.Control
      System.Web.UI.HtmlControls.HtmlControl
         System.Web.UI.HtmlControls.HtmlImage

[Visual Basic]
Public Class HtmlImage
   Inherits HtmlControl
[C#]
public class HtmlImage : HtmlControl
[C++]
public __gc class HtmlImage : public HtmlControl
[JScript]
public class HtmlImage extends HtmlControl

Thread Safety

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

Remarks

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.

Example

[Visual Basic, C#, JScript] The following example demonstrates how to programmatically modify the properties of an HtmlImage control when an HtmlButton is clicked.

[Visual Basic] 
<%@ Page Language="VB" AutoEventWireup="True" %>

<html>
 <head>
 
    <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
 
  </script>
 
 </head>
 
 <body>
 
    <form runat="server">
 
       <h3>HtmlImage Example</h3>
       
       <center>
 
          <button id="Button1"
                  OnServerClick="Image1_Click" 
                  runat="server">
          Image 1
          </button>
 
          <button id="Button2"
                  OnServerClick="Image2_Click" 
                  runat="server">
          Image 2
          </button>
 
          <button id="Button3"
                  OnServerClick="Image3_Click" 
                  runat="server">
          Image 3
          </button>
 
       </center>
       
       <br><br>
     
       <img id ="Image1"
            Src="image1.jpg"
            Width="500"
            Height="226"
            Alt="Image 1"
            Border="5"
            Align="center" 
            runat=server/>
       Enter the caption for this image here.
    
    </form>
 
 </body>
 </html>
   

[C#] 
<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
 <head>
 
    <script language="C#" runat="server">
        
       void Image1_Click(object sender, EventArgs e) 
       {
          Image1.Src="image1.jpg";
          Image1.Height=226;
          Image1.Width=500;
          Image1.Border=5;
          Image1.Align="center";
          Image1.Alt="Image 1";
       }
    
       void Image2_Click(object sender, EventArgs e) 
       {
          Image1.Src="image2.jpg";
          Image1.Height=480;
          Image1.Width=640;
          Image1.Border=7;
          Image1.Align="left";
          Image1.Alt="Image 2";
       }
 
       void Image3_Click(object sender, EventArgs e) 
       {
          Image1.Src="image3.jpg";
          Image1.Height=413;
          Image1.Width=631;
          Image1.Border=3;
          Image1.Align="right";
          Image1.Alt="Image 3";
       }
 
    </script>
 
 </head>
 
 <body>
 
    <form runat="server">
 
       <h3>HtmlImage Example</h3>
       
       <center>
 
          <button id="Button1"
                  OnServerClick="Image1_Click" 
                  runat="server">
          Image 1
          </button>
 
          <button id="Button2"
                  OnServerClick="Image2_Click" 
                  runat="server">
          Image 2
          </button>
 
          <button id="Button3"
                  OnServerClick="Image3_Click" 
                  runat="server">
          Image 3
          </button>
 
       </center>
       
       <br><br>
     
       <img id ="Image1"
            Src="image1.jpg"
            Width="500"
            Height="226"
            Alt="Image 1"
            Border="5"
            Align="center" 
            runat=server/>
       Enter the caption for this image here.
    
    </form>
 
 </body>
 </html>
   

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

<html>
 <head>
 
    <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"
    }
 
  </script>
 
 </head>
 
 <body>
 
    <form runat="server">
 
       <h3>HtmlImage Example</h3>
       
       <center>
 
          <button id="Button1"
                  OnServerClick="Image1_Click" 
                  runat="server">
          Image 1
          </button>
 
          <button id="Button2"
                  OnServerClick="Image2_Click" 
                  runat="server">
          Image 2
          </button>
 
          <button id="Button3"
                  OnServerClick="Image3_Click" 
                  runat="server">
          Image 3
          </button>
 
       </center>
       
       <br><br>
     
       <img id ="Image1"
            Src="image1.jpg"
            Width="500"
            Height="226"
            Alt="Image 1"
            Border="5"
            Align="center" 
            runat=server/>
       Enter the caption for this image here.
    
    </form>
 
 </body>
 </html>
   

[C++] No example is available for C++. To view a Visual Basic, C#, or JScript example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Namespace: System.Web.UI.HtmlControls

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

Assembly: System.Web (in System.Web.dll)

See Also

HtmlImage Members | System.Web.UI.HtmlControls Namespace | HtmlControl | HtmlButton

Show: