KpiElement.TargetValue Property

Gets or sets a measure that provides data for calculating the target value.

Namespace: DevExpress.DashboardCommon

Assembly: DevExpress.Dashboard.v22.2.Core.dll

NuGet Packages: DevExpress.Dashboard.Core, DevExpress.Win.Dashboard.Design

Declaration

C#

public Measure TargetValue { get; set; }

VB.NET

Public Property TargetValue As Measure

Property Value

Type	Description
Measure	A Measure object that provides data for calculating the target value.

Remarks

The KpiDashboardItem<TKpiElement> descendants, such as the CardDashboardItem or GaugeDashboardItem, are used to present KPI data. These dashboard items display a number of individual elements (cards and gauges respectively) that show the difference between the actual and target values of a particular parameter. To provide data for each of these elements, you need to specify a pair of measures, where one of these measures contains data used to calculate the actual value, and the other provides data for the target value.

Use the TargetValue property to specify a measure that will be used to calculate the target value. To specify a measure for the actual value, use the KpiElement.ActualValue property.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the TargetValue property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-bind-a-card-dashboard-item-to-data-in-code-e4770/CS/Dashboard_CreateCards/Form1.cs#L21

card.ActualValue = new Measure("Extended Price", SummaryType.StdDev);
card.TargetValue = new Measure("Extended Price", SummaryType.StdDevp);
cards.Cards.Add(card);

how-to-bind-a-gauge-dashboard-item-to-data-in-code-e4771/CS/Dashboard_CreateGauges/Form1.cs#L21

gauge.ActualValue = new Measure("Extended Price", SummaryType.Average);
gauge.TargetValue = new Measure("Extended Price", SummaryType.Max);
gauges.Gauges.Add(gauge);

how-to-bind-a-card-dashboard-item-to-data-in-code/CS/DXApplication1/ViewerForm1.cs#L38

card.ActualValue = new Measure("RevenueQTD (Sum)");
card.TargetValue = new Measure("RevenueQTDTarget (Sum)");
cards.Cards.Add(card);

VB.NET

how-to-bind-a-card-dashboard-item-to-data-in-code-e4770/VB/Dashboard_CreateCards/Form1.vb#L23

card.ActualValue = New Measure("Extended Price", SummaryType.StdDev)
card.TargetValue = New Measure("Extended Price", SummaryType.StdDevp)
cards.Cards.Add(card)

how-to-bind-a-gauge-dashboard-item-to-data-in-code-e4771/VB/Dashboard_CreateGauges/Form1.vb#L23

gauge.ActualValue = New Measure("Extended Price", SummaryType.Average)
gauge.TargetValue = New Measure("Extended Price", SummaryType.Max)
gauges.Gauges.Add(gauge)

how-to-bind-a-card-dashboard-item-to-data-in-code/VB/DXApplication1/ViewerForm1.vb#L36

card.ActualValue = New Measure("RevenueQTD (Sum)")
card.TargetValue = New Measure("RevenueQTDTarget (Sum)")
cards.Cards.Add(card)