Skip to main content
.NET Framework 4.6.2+

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

PropertyEditor.ControlValueChanged Event

In the PropertyEditor class’ descendants, can be raised after the control’s value has been changed.

Namespace: DevExpress.ExpressApp.Editors

Assembly: DevExpress.ExpressApp.v24.2.dll

NuGet Package: DevExpress.ExpressApp

#Declaration

public event EventHandler ControlValueChanged

#Event Data

The ControlValueChanged event's data class is EventArgs.

#Remarks

Handle this event to perform custom actions with the newly set control value.

The ControlValueChanged event is raised in the OnControlValueChanged method. However, this method is not called in the PropertyEditor class, because there is no access to the actual control that displays the bound property. So, in the PropertyEditor class’ descendants, call the OnControlValueChanged method after the control’s value has been changed. This is recommended because the built-in Windows Forms LockController subscribes to the ControlValueChanged event to check whether the property bound to the Property Editor is modified in another View at the same time. If so, this Controller shows a confirmation message so that an end-user can resolve this situation. The built-in Windows Forms Property Editors call the OnControlValueChanged method in the EditBase.EditValueChanged event handler (EditBase is the basic class of editors from the XtraEditors library).

The LockController is designed for Windows Forms applications only. So, in ASP.NET Web Forms descendants of the PropertyEditor class, you do not have to call the OnControlValueChanged method if it is not required for your custom actions.

See Also