HtmlInputImage.Src Property


Gets or sets the location of the image file.

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

public string Src { get; set; }

Property Value

Type: System.String

The location of the image file. The default value is an empty string ("").

Use the Src property to specify the location of the image to display in the HtmlInputImage control. If the image is not available, the text specified in the Alt property is displayed.

You can use a relative or absolute URL. A relative URL relates the location of the image to the location of the Web page without specifying a complete path on the server. The path is relative to the location of the Web page. This makes it easier to move the entire site to another directory on the server without updating the path to the image in code. You can use the relative path " ~/ " to refer to the current virtual directory where the page is located. For example, the value of Src for <input type="image" runat="server" src="~/abc/d.gif"> on a page in the "XspTest" virtual directory is <input type="image" src="/XspText/abc/d.gif">. An absolute URL provides the complete path. Therefore, moving the site to another directory requires that you update the code.

The following code example demonstrates how to use the Src property to specify the path to an image displayed in the HtmlInputImage control.

<%@ Page Language="C#" AutoEventWireup="true" %>

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

     protected void SubmitBtn_Click(object sender, ImageClickEventArgs e)
       Message.InnerHtml = "The Submit button was clicked.";

     protected void ClearBtn_Click(object sender, ImageClickEventArgs e)
       Message.InnerHtml = "The Clear button was clicked.";


   <head runat="server">
    <title>HtmlInputImage Example</title>
      <h3>HtmlInputImage Example</h3>

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

         <input type="image"
                alt="Submit button" 
                id="Image1" />

         <input type="image"
                alt="Clear button" 
                id="Image2" />


         <span id="Message" 





.NET Framework
Available since 1.1
Return to top