永利最大(官方)网站

上一讲跟大家介绍了如何在 DevExpress Dashboard 中自定义连接设置，本文将为你介绍如何创建新的仪表盘参数并指定它的相关设置。

在仪表盘设计器中创建参数

首先找到Ribbon菜单中的Data Source，然后单击它下面的Parameters，如图：

在弹出的对话框中单击Add添加新参数：

指定以下设置：

最后单击OK表示确定。

查询编辑器设置

查询编辑器设置有三种方式（如下图）。从LookUpSettings下拉列表中可以选择你需要的类型:

• No Look-Up - Value使用一个静态值作为参数

• StaticList - 单击省略号按钮为当前的仪表盘参数添加静态值：

这样Value就指定了默认的参数值。

• DynamicList - 从当前的数据源中选择一系列的值。选择需要的DataSource，还有仪表盘参数显示名和值所需的数据元素：

用代码创建参数

仪表盘提供 Dashboard.Parameters 属性，它用于访问仪表盘参数。下面介绍一下如何用代码来创建参数。

首先，用查询编辑器设置（DashboardParameter.LookUpSettings属性）创建一个参数，然后将它添加到仪表盘的参数当中。参考代码如下：

• No Look-Up：

DashboardParameter parameter1 = new DashboardParameter("Parameter1", typeof(string), "Beverages", "", true, null);

• StaticLis - 使用 StaticListLookUpSettings.Values 属性去访问仪表盘参数的静态值：

StaticListLookUpSettings settings = new StaticListLookUpSettings();
settings.Values = new string[] {"Beverages", "Condiments"};
DashboardParameter parameter2 = new DashboardParameter("Parameter2", typeof(string), "Beverages", "", true, settings);

• DynamicList - 使用 DynamicListLookUpSettings.DataSource 属性指定仪表盘参数所需的数据源。DynamicListLookUpSettings.ValueMember和DynamicListLookUpSettings.DisplayMember可以指定参数值的数据元素。

DynamicListLookUpSettings settings = new DynamicListLookUpSettings();
settings.DataSource = ds;
settings.ValueMember = "CategoryName";
settings.DisplayMember = "CategoryName";
DashboardParameter parameter3 = new DashboardParameter("Parameter3", typeof(string), "Beverages", "", true, settings);