Parameters

target

The name of a server System.Web.UI.Control that handles the client callback. The control must implement the System.Web.UI.ICallbackEventHandler interface and provide a ICallbackEventHandler.RaiseCallbackEvent(string) method.

argument

An argument passed from the client script to the server

clientCallback

The name of the client event handler that receives the result of the successful server event.

context

The client script that is evaluated on the client prior to initiating the callback. The result of the script is passed back to the client event handler.

clientErrorCallback

The name of the client event handler that receives the result when an error occurs in the server event handler.

useAsync

true to perform the callback asynchronously; false to perform the callback synchronously.

Returns

The name of a client function that invokes the client callback.

Remarks

This overload of the erload:System.Web.UI.ClientScriptManager.GetCallbackEventReference method takes a target string parameter instead of a System.Web.UI.Control parameter. Use this overload when you want the callback to go back to something other than a string containing the Control.UniqueID of the control.

Additionally, this overload of the erload:System.Web.UI.ClientScriptManager.GetCallbackEventReference method requires a useAsync and a clientErrorCallback parameter. The useAsync parameter allows you to perform the client callback asynchronously by setting the value to true. The overload versions of this method that do not require the useAsync parameter set the value to false by default. The clientErrorCallback parameter allows you to define the name of the client function that is called if the server handler, the ICallbackEventHandler.RaiseCallbackEvent(string) method, returns an error. The overload versions of this method that do not require the clientErrorCallback parameter set the value to null.

For more information on this method, see the remarks for the overload ClientScriptManager.GetCallbackEventReference(Control, string, string, string) method.

Requirements