ASPxGaugeControl.Value Property

Gets or sets the ASPxGaugeControl’s value.

Namespace: DevExpress.Web.ASPxGauges

Assembly: DevExpress.Web.ASPxGauges.v24.1.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;
}