Page.GetPostBackEventReference Method (Control, String)
.NET Framework (current version)
Note: This API is now obsolete.
Namespace:
System.Web.UI
Assembly: System.Web (in System.Web.dll)
Return to top
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.
Assembly: System.Web (in System.Web.dll)
[ObsoleteAttribute("The recommended alternative is ClientScript.GetPostBackEventReference. http://go.microsoft.com/fwlink/?linkid=14202")] public string GetPostBackEventReference( Control control, string argument )
Parameters
- control
-
Type:
System.Web.UI.Control
The server control to process the postback.
- argument
-
Type:
System.String
The parameter passed to the server control.
Return Value
Type: System.StringA string that, when treated as script on the client, initiates the postback.
This method has been deprecated. Use the GetPostBackEventReference method in the ClientScriptManager class instead.
public class MyControl : Control, IPostBackEventHandler { // Create an integer property that is displayed when // the page that contains this control is requested // and save it to the control's ViewState property. public int Number { get { if ( ViewState["Number"] !=null ) return (int) ViewState["Number"]; return 50; } set { ViewState["Number"] = value; } } // Implement the RaisePostBackEvent method from the // IPostBackEventHandler interface. If 'inc' is passed // to this method, it increases the Number property by one. // If 'dec' is passed to this method, it decreases the // Number property by one. public void RaisePostBackEvent(string eventArgument) { if ( eventArgument == "inc" ) Number = Number + 1; if ( eventArgument == "dec" ) Number = Number - 1; } [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] protected override void Render(HtmlTextWriter writer) { // Converts the Number property to a string and // writes it to the containing page. writer.Write("The Number is " + Number.ToString() + " (" ); // Uses the GetPostBackEventReference method to pass // 'inc' to the RaisePostBackEvent method when the link // this code creates is clicked. writer.Write("<a href=\"javascript:" + Page.GetPostBackEventReference(this,"inc") + "\">Increase Number</a>"); writer.Write(" or "); // Uses the GetPostBackEventReference method to pass // 'dec' to the RaisePostBackEvent method when the link // this code creates is clicked. writer.Write("<a href=\"javascript:" + Page.GetPostBackEventReference(this,"dec") + "\">Decrease Number</a>"); } }
.NET Framework
Available since 1.1
Available since 1.1
Show: