ClientScriptManager::GetPostBackEventReference Method (PostBackOptions, Boolean)
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 PostBackOptions object. Optionally, registers the event reference for validation.
Assembly: System.Web (in System.Web.dll)
public: String^ GetPostBackEventReference( PostBackOptions^ options, bool registerForEventValidation )
Parameters
- options
- Type: System.Web.UI::PostBackOptions
A PostBackOptions that defines the postback.
- registerForEventValidation
- Type: System::Boolean
true to register the event reference for validation; otherwise, false.
Return Value
Type: System::StringA string that, when treated as script on the client, initiates the client postback.
| Exception | Condition |
|---|---|
| ArgumentNullException | The PostBackOptions is nullptr. |
To implement the IPostBackEventHandler interface for a Page object, 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.
If registerForEventValidation is true, the GetPostBackEventReference(PostBackOptions, Boolean) method calls the RegisterForEventValidation(String, String) method to register the event reference for validation with a unique control ID that represents the client control that is generating the event.
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.