The requested page is not available for the requested platform. You are viewing the content for Default platform.

ASPxClientGlobalEvents.CallbackError Event

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

Declaration

CallbackError: ASPxClientEvent<ASPxClientGlobalCallbackErrorEventHandler<ASPxClientGlobalEvents>>

Event Data

The CallbackError event handler receives an argument of the ASPxClientGlobalCallbackErrorEventArgs type. 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.
message Gets the error message that describes the server error that occurred.

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 that occurs during server-side processing of a callback leads to the 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 within handlers of their server-side events, and to pass the related error information to the client for further processing. On the client side, the error can be processed either on the level of an individual control (by using the control's CallbackError event) or centrally - by handling the ASPxClientGlobalEvents object's CallbackError event.

Examples

<dx:ASPxGlobalEvents ID="ASPxGlobalEvents1" runat="server">
    <ClientSideEvents 
       BeginCallback="function(s, e) {
        alert('BeginCallback ' + e.control.name);
    }" CallbackError="function(s, e) {
        alert('CallbackError ' + e.control.name);
    }" EndCallback="function(s, e) {
        alert('EndCallback ' + e.control.name);
    }" />
</dx:ASPxGlobalEvents>
See Also