PostBackOptions.ActionUrl Property

 

Gets or sets the target URL for the postback of a Web Forms page.

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

Public Property ActionUrl As String

Property Value

Type: System.String

The URL for the postback of a Web Forms page. The default value is an empty string ("").

The ActionUrl property of the PostBackOptions class specifies the URL for the action attribute of a Web Forms page. The ActionUrl property can be used to specify which Web Forms page to post data back to, causing a cross-page post. For more information on cross-page posting, see Cross-Page Posting in ASP.NET Web Forms.

The following code example demonstrates using the ActionUrl property of a PostBackOptions object to cause a cross-page postback if a user positions the mouse pointer on a Label control.

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)

    Dim reference As String = Page.ClientScript.GetPostBackEventReference _
      (New PostBackOptions(Me, "", "http://www.wingtiptoys.com", False, True, False, True, False, ""))
    Label1.Attributes.Add("onmouseover", reference)

  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>ActionUrl Example Page</title>
  </head>
  <body>
    <form id="form1" runat="server">
      <h3>PostBackOptions ActionUrl Example</h3>
      <asp:Label runat="server" 
        id="Label1" >
        Placing the mouse pointer on this label will cause a cross-page post to occur.
      </asp:Label>
    </form>
  </body>
</html>

.NET Framework
Available since 2.0
Return to top
Show: