Skip to main content

ASPxClientControlCollection.CallbackError Event

Fires on the client if any server error occurs during server-side processing of a callback sent by any DevExpress web control.

Declaration

CallbackError: ASPxClientEvent<ASPxClientGlobalCallbackErrorEventHandler<ASPxClientControlCollection>>

Event Data

The CallbackError event's data class is ASPxClientGlobalCallbackErrorEventArgs. The following properties provide information specific to this event:

Property Description
control Gets an object that initiated a callback.
handled Gets or sets whether the event is handled and the default error handling actions are not required. Inherited from ASPxClientCallbackErrorEventArgs.
message Gets the error message that describes the server error that occurred. Inherited from ASPxClientCallbackErrorEventArgs.

Remarks

The CallbackError event enables you to centrally respond to server errors that might occur as a result of server-side callback processing initiated by any DevExpress web control. You can handle this event to perform specific client-side actions, such as displaying explanatory text or an image related to the error, for example.

Typically, a server error which occurs during server-side processing of a callback leads to web application hanging, because in this case, no proper response is generated for a control that initiated the callback. However, AJAX-enabled web controls from the DevExpress product line are able to automatically catch server errors occurring in handlers of their server-side events, and to pass the related error information to the client for further processing through the CallbackError event’s argument.

ASPxClientControl.GetControlCollection().CallbackError.AddHandler(function (s, e) {
     ErrorLabel.SetText(e.message);
     e.handled = true;
});
See Also