LegendItem.Url Property

Definition

Namespace:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.DataVisualization.dll

Gets or sets the destination URL of a legend item.

public:
 property System::String ^ Url { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.Bindable(true)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.Attribute)]
public string Url { get; set; }

[<System.ComponentModel.Bindable(true)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.Attribute)>]
member this.Url : string with get, set

Public Property Url As String

Property Value

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.

Implements

Url

Attributes

BindableAttribute PersistenceModeAttribute

Remarks

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.

Note

This property is applicable to the entire LegendItem.