ASPxGaugeControl.Value Property

Gets or sets the ASPxGaugeControl’s value.

Namespace: DevExpress.Web.ASPxGauges

Assembly: DevExpress.Web.ASPxGauges.v20.2.dll

NuGet Package: DevExpress.Web.Visualization

Declaration

C#

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

VB.NET

<DefaultValue("")>
Public Property Value As String

Property Value

Type	Default	Description
String	String.Empty	A string value that specifies the control’s value.

Remarks

The ASPxGaugeControl’s value specifies the value or text of the first gauge found, contained within the ASPxGaugeControl.Gauges collection.

The value is calculated as shown below:

• Digital

  C#

  IDigitalGauge dGauge = gaugeControl.Gauges[0] as IDigitalGauge;
  if (dGauge != null)
      value = dGauge.Text;
  

• Circular

  C#

  ICircularGauge cGauge = gaugeControl.Gauges[0] as ICircularGauge;
  if (cGauge != null && cGauge.Scales.Count > 0)
      value = cGauge.Scales[0].Value;
  

• Linear

  C#

  ILinearGauge lGauge = gaugeControl.Gauges[0] as ILinearGauge;
  if (cGauge != null && lGauge.Scales.Count > 0)
      value = lGauge.Scales[0].Value;
  

• State Indicator

  C#

  IStateIndicatorGauge sGauge = gaugeControl.Gauges[0] as IStateIndicatorGauge;
  if (sGauge != null && sGauge.Indicators.Count > 0)
      value = sGauge.Indicators[0].StateIndex;
  

Example

This example demonstrates how to change the ASPxGaugeControl’s value using an ASPxSpinEdit.

Handle the spin editor’s ValueChanged event to call the gauge’s client-side ASPxClientGaugeControl.PerformCallback method. Pass the spin editor’s value as a parameter. As a result, the ASPxGaugeControl.CustomCallback event is raised, and the spin editor’s new value, specified by the e.Parameter property, is assigned to the ASPxGaugeControl.Value property. After a custom callback has been performed, the ASPxGaugeControl is automatically re-rendered.

The animation below shows the result:

ASPX

<dxe:ASPxSpinEdit runat="server" Number="0" Width="157px" Height="21px" ID="ASPxSpinEdit1">
    <ClientSideEvents ValueChanged="function(s, e) {
        gc.PerformCallback(s.GetValue());}">
    </ClientSideEvents>
</dxe:ASPxSpinEdit>

C#

protected void ASPxGaugeControl2_CustomCallback(object source,
                  DevExpress.Web.CallbackEventArgsBase e) {
    ASPxGaugeControl2.Value = e.Parameter;
}

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the Value 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#

dataview-how-to-display-different-gauges-for-different-cells-based-upon-some-condition-e1789/CS/WebApplication2/Default.aspx.cs#L34

    c.Visible = isDigital && c.Gauges[0] is DigitalGauge || !isDigital && c.Gauges[0] is CircularGauge;
    c.Value = (container.DataItem as DataRowView)["value"].ToString();
}

VB.NET

dataview-how-to-display-different-gauges-for-different-cells-based-upon-some-condition-e1789/VB/WebApplication2/Default.aspx.vb#L32

    c.Visible = isDigital AndAlso TypeOf c.Gauges(0) Is DigitalGauge OrElse Not isDigital AndAlso TypeOf c.Gauges(0) Is CircularGauge
    c.Value = (TryCast(container.DataItem, DataRowView))("value").ToString()
End Sub