This documentation is archived and is not being maintained.

ClientScriptManager::GetPostBackEventReference Method (Control, String)

Returns a string that can be used in a client event to cause postback to the server. The reference string is defined by the specified control that handles the postback and a string argument of additional event information.

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

public:
String^ GetPostBackEventReference(
	Control^ control, 
	String^ argument
)

Parameters

control
Type: System.Web.UI::Control
The server Control that processes the postback on the server.
argument
Type: System::String
A string of optional arguments to pass to the control that processes the postback.

Return Value

Type: System::String
A string that, when treated as script on the client, initiates the postback.

ExceptionCondition
ArgumentNullException

The specified Control is nullptr.

To implement the IPostBackEventHandler interface for a Page, use the @ Implements directive.

The GetPostBackEventReference method can be used with the Button control when the UseSubmitBehavior property is false. In this scenario, the GetPostBackEventReference method returns the client postback event for the Button control.

The following code example demonstrates the use of the GetPostBackEventReference method. The custom control, MyControl, implements the IPostBackEventHandler interface. When the button on the page is clicked, the RaisePostBackEvent method of the custom control is invoked.

No code example is currently available or this language may not be supported.

The following code example has the same functionality as the preceding one, except that instead of a custom control, the Page class implements the IPostBackEventHandler interface.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: