This documentation is archived and is not being maintained.

HyperLink.ImageUrl Property

Gets or sets the path to an image to display for the HyperLink control.

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

public virtual string ImageUrl { get; set; }
<asp:HyperLink ImageUrl="String" />

Property Value

Type: System.String
The path to the image to display for the HyperLink control. The default value is an empty string ("").

The HyperLink control can be displayed as text or an image. Use the ImageUrl property to specify an image to display for the HyperLink control.


If both the Text and ImageUrl properties are set, the ImageUrl property takes precedence. If the image is unavailable, the text in the Text property is displayed. In browsers that support ToolTip functionality, the Text property also becomes the ToolTip.

The following example demonstrates how to set the ImageUrl property to specify the path to the image to display.

<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
<html xmlns="" >
    <title>HyperLink Example</title>
<form id="Form1" runat="server">

   <h3>HyperLink Example</h3>

   Click on the HyperLink:<br />  

   <asp:HyperLink id="hyperlink1" 
                  Text="Microsoft Official Site"

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