New to Telerik UI for ASP.NET AJAX? Download free 30-day trial

OnValueChanged

The OnValueChanged client-side event handler is called when the user changes the value of the input control. The event occurs immediately after the control loses focus and its value has been updated, but before the server-side TextChanged event.

The OnValueChanged event only occurs if the user entered a valid value that is different from the old value.

The OnValueChanged event is supported by all RadInput controls.

Two parameters are passed to the event handler:

  • sender is input control.

  • eventArgs has the following methods:

    • set_cancel() lets you permit or block the postback that occurs when the AutoPostBack property is True. Calling set_cancel(true) prevents the postback.

    • get_oldValue() returns the string value of the input control before the user made any changes.

    • get_newValue() returns the string value that was just assigned to the input control.

Range checking occurs after the OnValueChanged event. If the user enters a value that is invalid only because it is out of range, the OnValueChanged event still occurs, and get_newValue() returns the value that is out of range.

In addition to the methods listed above, on RadDateInput the eventArgs parameter has two additional methods:

  • get_oldDate() returns the date value of the control before the user made any changes, or null if the value was unassigned.

  • get_newDate() returns the date value that was just assigned to the control, or null if the user entered an empty string.

The following example uses the OnValueChanged event to prevent a postback if the user entered an empty string:

<telerik:RadDateInput RenderMode="Lightweight" ID="RadDateInput1" runat="server" AutoPostBack="True">
    <ClientEvents OnValueChanged="PreventPostback" />
</telerik:RadDateInput>
<script type="text/javascript">
    function PreventPostback(sender, eventArgs)
    {
        if (eventArgs.get_newValue() == "")
            eventArgs.set_cancel(true);
    }
</script>

See Also

In this article