MapArea.Url Property

.NET Framework (current version)
 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets or sets the destination URL or anchor point of the map area.

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

[BindableAttribute(true)]
[PersistenceModeAttribute(PersistenceMode.Attribute)]
public string Url { get; set; }

Property Value

Type: System.String

A string value that represents the destination URL or anchor point of the map area. 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.

When you set this property, a client-side image map will automatically be created, and a map area will be created with the 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 HREF property is set for a data point, then HTML code similar to the following will be generated at run time:

&lt;img id="Chart1" USEMAP="#Chart1ImageMap" src="ChartPic_000002.jpg?6735e83b-f0cd-4225-8be4-047695a61040" border="0" /&gt;<BR>...<BR>&lt;MAP NAME="Chart1ImageMap"&gt;<BR>&lt;AREA SHAPE="rect" HREF="http://www.healthquotes.ca" COORDS= "69,120,106,309"&gt;<BR>&lt;/MAP&gt;

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), such as TARGET=-Blank, can be specified by using the MapAreaAttributes property.

This property allows you to set special keywords to display different types of chart-related data.

To create image maps that have user-defined coordinates, use the MapAreas property of the root Chart object.

.NET Framework
Available since 4.0
Return to top
Show: