HyperLink.ImageUrl Property (System.Web.UI.WebControls)

ImageUrl Property

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

HyperLink..::.ImageUrl Property

Updated: November 2007

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)

Syntax

Visual Basic (Declaration)

<BindableAttribute(True)> _
Public Overridable Property ImageUrl As String

Visual Basic (Usage)

Dim instance As HyperLink
Dim value As String

value = instance.ImageUrl

instance.ImageUrl = value

[BindableAttribute(true)]
public virtual string ImageUrl { get; set; }

Visual C++

[BindableAttribute(true)]
public:
virtual property String^ ImageUrl {
    String^ get ();
    void set (String^ value);
}

/** @property */
/** @attribute BindableAttribute(true) */
public String get_ImageUrl()
/** @property */
/** @attribute BindableAttribute(true) */
public  void set_ImageUrl(String value)

JScript

public function get ImageUrl () : String
public function set ImageUrl (value : String)

ASP.NET

<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 ("").

Remarks

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.

Note:
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.

Topic	Location
How to: Add HyperLink Web Server Controls to a Web Forms Page	Building ASP .NET Web Applications in Visual Studio
How to: Add HyperLink Web Server Controls to a Web Forms Page	Building ASP .NET Web Applications
How to: Add HyperLink Web Server Controls to a Web Forms Page	Building ASP .NET Web Applications
How to: Add HyperLink Web Server Controls to a Web Forms Page (Visual Studio)	Building ASP .NET Web Applications in Visual Studio
How to: Insert HTML Hyperlinks and Bookmarks in Design View	Building ASP .NET Web Applications in Visual Studio
How to: Insert HTML Hyperlinks and Bookmarks in Design View	Building ASP .NET Web Applications in Visual Studio

Examples

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

Visual Basic

<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html  >
<head>
    <title>HyperLink Example</title>
</head>
<body>
<form id="Form1" runat="server">


   <h3>HyperLink Example</h3>

   Click on the HyperLink:<br />  

   <asp:HyperLink id="hyperlink1" 
                  ImageUrl="images/pict.jpg"
                  NavigateUrl="http://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_new"
                  runat="server"/>       
</form>
</body>
</html>

<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html  >
<head>
    <title>HyperLink Example</title>
</head>
<body>
<form id="Form1" runat="server">

   <h3>HyperLink Example</h3>

   Click on the HyperLink:<br />  

   <asp:HyperLink id="hyperlink1" 
                  ImageUrl="images/pict.jpg"
                  NavigateUrl="http://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_new"
                  runat="server"/>       
</form>
</body>
</html>

JScript

<%@ Page Language="JScript" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html  >
<head>
    <title>HyperLink Example</title>
</head>
<body>
<form id="Form1" runat="server">

  <h3>HyperLink Example</h3>

   Click on the HyperLink:<br />  

   <asp:HyperLink id="hyperlink1" 
                  ImageUrl="images/pict.jpg"
                  NavigateUrl="http://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_new"
                  runat="server"/>       
</form>
</body>
</html>

Platforms

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, 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.

Version Information