GetCallbackEventReference Method (String, String, String, String, String, Boolean)

ClientScriptManager.GetCallbackEventReference Method (String, String, String, String, String, Boolean)


Obtains a reference to a client function that, when invoked, initiates a client call back to server events. The client function for this overloaded method includes a specified target, argument, client script, context, error handler, and Boolean value.

Namespace:   System.Web.UI
Assembly:  System.Web (in System.Web.dll)

public string GetCallbackEventReference(
	string target,
	string argument,
	string clientCallback,
	string context,
	string clientErrorCallback,
	bool useAsync


Type: System.String

The name of a server Control that handles the client callback. The control must implement the ICallbackEventHandler interface and provide a RaiseCallbackEvent method.

Type: System.String

An argument passed from the client script to the server

RaiseCallbackEvent method.

Type: System.String

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

Type: System.String

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.

Type: System.String

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

Type: System.Boolean

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

Return Value

Type: System.String

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

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

Additionally, this overload of the 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 RaiseCallbackEvent 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 GetCallbackEventReference method.

Legacy Code Example

The following code example demonstrates how to use two overloads of the GetCallbackEventReference method in a client callback scenario that increments integers.

Two callback mechanisms are shown; the difference between them is the use of the context parameter. A ReceiveServerData1 client callback function is provided using the context parameter. In contrast, the ReceiveServerData2 client callback function is defined in a <script> block on the page. A RaiseCallbackEvent method is the server handler that increments the value that is passed to it and the GetCallbackResult method returns the incremented value as a string. If the RaiseCallbackEvent method returns an error, then the client function ProcessCallBackError is called.

Code snippet is not found. Confirm that the code snippet name 'System.Web.UI.ClientScriptManager7' is correct.

.NET Framework
Available since 2.0
Return to top
© 2015 Microsoft