LegendItem.Url Property

.NET Framework (current version)
 

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)

<BindableAttribute(True)>
<PersistenceModeAttribute(PersistenceMode.Attribute)>
Public Property Url As String

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="http://www.healthquotes.ca" 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.

System_CAPS_noteNote

This property is applicable to the entire LegendItem.

.NET Framework
Available since 4.0
Return to top
Show: