Skip to main content
Tab

ASPxCloudControl.ValueField Property

Gets or sets the data source field which provides item values.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v24.2.dll

Declaration

[DefaultValue("")]
public string ValueField { 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 values.

Remarks

When the ASPxCloudControl is data bound, the name of the data field that provides item values is specified by the ValueField property. Otherwise, if the control functions in unbound mode, use the item’s CloudControlItem.Value property instead.

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