This documentation is archived and is not being maintained.

LegendItem.Url Property

Gets or sets the destination URL of a legend item.

Namespace:  System.Web.UI.DataVisualization.Charting
Assembly:  System.Web.DataVisualization (in System.Web.DataVisualization.dll)

public string Url { get; set; }

Property Value

Type: System.String
A string value that represents the destination URL of a legend item. To use an absolute URL, start the string expression with either "http://" or "www.". If the string does not start with either of these prefixes it will be treated as a relative URL.



If you set this property, a client-side image map will be automatically created. A map area will also be created with its HREF attribute set to the specified anchor or URL. This map area will also use the dimensions that correspond to the relevant chart element. For example, if the Url property is set for a data point, then HTML code similar to the following will be generated at run time:

<img id="Chart1" USEMAP="#Chart1ImageMap" src="ChartPic_000002.jpg?6735e83b-f0cd-4225-8be4-047695a61040" border="0" />...<MAP NAME="Chart1ImageMap"><AREA SHAPE="rect" HREF="" COORDS= "69,120,106,309"></MAP>

Setting this property will have no effect if the IsMapEnabled property is set to false. The default value is true.

Important   To create an image map in this manner, the RenderType property of the Chart object must be set to ImageTag. It is possible to create an image map when using binary streaming, but another technique must be used.

Attributes of the map area(s), for example, TARGET=_Blank, can be specified by using the MapAreaAttributes property.

The Url property allows you to set special keywords to display different types of chart-related data. For more information, see Keywords (Chart Controls).

To create image maps that have user-defined coordinates, use the MapAreas property of the root Chart object. For more information, see Chart Image Rendering (Chart Controls).


This property is applicable to the entire LegendItem.

.NET Framework

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.