Button.PostBackUrl 属性

参考

定义

命名空间:: System.Web.UI.WebControls

程序集:: System.Web.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

获取或设置单击 Button 控件时从当前页发送到的网页的 URL。

public:
 virtual property System::String ^ PostBackUrl { System::String ^ get(); void set(System::String ^ value); };

[System.Web.UI.Themeable(false)]
public virtual string PostBackUrl { get; set; }

[<System.Web.UI.Themeable(false)>]
member this.PostBackUrl : string with get, set

Public Overridable Property PostBackUrl As String

属性值

String

单击 Button 控件时从当前页发送到的网页的 URL。默认值为空字符串 ("")，表示将页回发到自身。

实现

PostBackUrl

属性: ThemeableAttribute

示例

下面的代码示例演示如何使用 PostBackUrl 属性执行跨页帖子。当用户单击控件时 Button ，页面会将文本框中输入的值发布到由 PostBackUrl 属性指定的目标页。若要运行此示例，还必须在此代码示例所在的同一目录中为目标页创建文件。下一个示例中提供了目标页的代码。

<%@ page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
  <title>Button.PostBackUrl Example</title>
</head>
<body>    
  <form id="form1" runat="server">
    
    <h3>Button.PostBackUrl Example</h3>

    Enter a value to post:
    <asp:textbox id="TextBox1" 
      runat="Server">
    </asp:textbox>

    <br /><br />

    <asp:button id="Button1" 
      text="Post back to this page"
      runat="Server">
    </asp:button>

    <br /><br />

    <asp:button id="Button2"
      text="Post value to another page" 
      postbackurl="Button.PostBackUrlPage2cs.aspx" 
      runat="Server">
    </asp:button>

  </form>
</body>
</html>

<%@ page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
  <title>Button.PostBackUrl Example</title>
</head>
<body>    
  <form id="form1" runat="server">
    
    <h3>Button.PostBackUrl Example</h3>

    Enter a value to post:
    <asp:textbox id="TextBox1" 
      runat="Server">
    </asp:textbox>

    <br /><br />

    <asp:button id="Button1" 
      text="Post back to this page"
      runat="Server">
    </asp:button>

    <br /><br />

    <asp:button id="Button2"
      text="Post value to another page" 
      postbackurl="Button.PostBackUrlPage2vb.aspx" 
      runat="Server">
    </asp:button>

  </form>
</body>
</html>

下面的代码示例演示如何使用 Page.PreviousPage 属性访问使用属性从另一个页面 PostBackUrl 发布的值。此页面获取从上一页发布的字符串，并将其显示给用户。如果尝试直接运行此代码示例，则会收到错误，因为字段的值 text 将为 null。请改用此代码创建目标页，并将文件放在与上一示例的代码相同的目录中。文件的名称必须与上一示例中为 PostBackUrl 属性指定的值相对应。运行上一示例的代码时，当跨页发布发生时，此页面将自动执行。

重要

此示例具有一个接受用户输入的文本框，这是一个潜在的安全威胁。默认情况下，ASP.NET 网页验证用户输入是否不包含脚本或 HTML 元素。有关详细信息，请参阅脚本侵入概述。

<%@ page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  
  void Page_Load (object sender, System.EventArgs e)
  {
    string text;
    
    // Get the value of TextBox1 from the page that 
    // posted to this page.
    text = ((TextBox)PreviousPage.FindControl("TextBox1")).Text;
    
    // Check for an empty string.
    if (text != "")
      PostedLabel.Text = "The string posted from the previous page is "
                         + text + ".";
    else
      PostedLabel.Text = "An empty string was posted from the previous page.";
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
  <title>Button.PostBackUrl Target Page Example</title>
</head>
<body>
  <form id="form1" runat="server">
    
    <h3>Button.PostBackUrl Target Page Example</h3>
      
    <br />
    
    <asp:label id="PostedLabel"
       runat="Server">
    </asp:label>

    </form>
</body>
</html>

<%@ 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_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
    
    Dim text As String
    
    ' Get the value of TextBox1 from the page that posted
    ' to this page.
    text = CType((PreviousPage.FindControl("TextBox1")), TextBox).Text
       
    ' Check for an empty string.
    If Not (text = "") Then
      PostedLabel.Text = "The string posted from the previous page is " _
                         & text & "."
    Else
      PostedLabel.Text = "An empty string was posted from the previous page."
    End If
    
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
  <title>Button.PostBackUrl Target Page Example</title>
</head>
<body>
  <form id="form1" runat="server">
    
    <h3>Button.PostBackUrl Target Page Example</h3>
       
    <br />
    
    <asp:label id="PostedLabel"
       runat="Server">
    </asp:label>

    </form>
</body>
</html>

注解

属性 PostBackUrl 允许使用 Button 控件执行跨页帖子。

注意

只有正确指定的路径才适用于此属性。例如，相对路径 (Test/default.aspx) 、绝对路径 () https://localhost/WebApp/default.aspx 和虚拟 (~\Test\default.aspx) 正常工作。格式不正确的路径（如“/Test/default.aspx”或“\Test\default.aspx”）不起作用。有关创建正确路径的讨论，请参阅 ASP.NET Web 项目路径。

将 PostBackUrl 属性设置为单击控件时要发布到的网页的 Button URL。例如，指定 Page2.aspx 会导致包含 Button 控件的页面发布到 Page2.aspx。如果未为 PostBackUrl 属性指定值，页面将发回到自身。

重要

使用具有服务器端验证的控件执行跨页回发时，应在处理回发之前检查页面 IsValid 的属性 true 。在跨页回发的情况下，要检查的页面是 PreviousPage。以下 VB 代码演示如何执行此操作：

Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
        If Page.PreviousPage.IsValid Then
            ' Handle the post back
        Else
            Response.Write("Invalid")
        End If
End Sub

有关跨页发布技术的详细信息，请参阅 ASP.NET Web 窗体中的跨页发布。

无法通过主题或样式表主题设置此属性。有关详细信息，请参阅 ThemeableAttribute 和 ASP.NET 主题和外观。

适用于

通过

Button.PostBackUrl 属性

定义

属性值

实现

示例

注解

适用于

另请参阅

其他资源