Skip to main content
A newer version of this page is available. .
Tab

ASPxCloudControl.NavigateUrlField Property

Gets or sets the data source field which provides URLs to the ASPxCloudControl‘s items.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v19.2.dll

Declaration

[DefaultValue("")]
public string NavigateUrlField { get; set; }

Property Value

Type Default Description
String String.Empty

A string value that specifies the name of the data source field which contains item URLs.

Remarks

An item’s description (text) is rendered as a link that when clicked, allows the user to drill into the selected category. When the ASPxCloudControl is data bound, the name of the data field that provides URLs for items is specified by the NavigateUrlField property. Otherwise, if the control functions in unbound mode, use the item’s CloudControlItem.NavigateUrl property to specify the item’s URL.

Example

This example illustrates how to bind the ASPxCloudControl to a data source. The ASPxCloudControl receives data from an MS Access database. The ASPxCloudControl implements specific properties that point to the data fields containing the necessary data. These are the ASPxCloudControl.TextField, ASPxCloudControl.ValueField and ASPxCloudControl.NavigateUrlField properties. The ASPxCloudControl.ItemDataBound event is used to customize values that are to be assigned to tag cloud element properties during data binding.

<%@ Page Language="C#" AutoEventWireup="true"  CodeFile="Default.aspx.cs" 
Inherits="_Default" %>
<%@ Register assembly="DevExpress.Web.v8.3, Version=8.3.2.0, Culture=neutral, 
PublicKeyToken=b88d1754d700e49a" namespace="DevExpress.Web.ASPxCloudControl" tagprefix="dxcc" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
    protected void Page_Load(object sender, EventArgs e) {
        string sql = "select * from country where Continent='North America'";
        AccessDataSource1.SelectCommand = sql;
        ASPxCloudControl1.ValueField = "Area";
    }
    protected void ASPxCloudControl1_ItemDataBound(object source, CloudControlItemEventArgs e) {
        e.Item.Text = e.Item.Text.ToUpper();
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    <dxcc:ASPxCloudControl ID="ASPxCloudControl1" runat="server" DataSourceID="AccessDataSource1" 
    NavigateUrlField="Name" NavigateUrlFormatString="javascript:void('{0}')" TextField="Name" 
    ValueField="Area" EnableViewState="False" OnItemDataBound="ASPxCloudControl1_ItemDataBound">
        </dxcc:ASPxCloudControl>
        <asp:AccessDataSource ID="AccessDataSource1" runat="server" DataFile="~/App_Data/Data.mdb">
        </asp:AccessDataSource>
    </div>
    </form>
</body>
</html>
See Also