LinkButton.PostBackUrl Свойство

Определение

Получает или задает URL-адрес страницы, на которую осуществляется передача с текущей страницы при нажатии элемента управления LinkButton.Gets or sets the URL of the page to post to from the current page when the LinkButton control is clicked.

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

URL-адрес веб-страницы, на которую осуществляется передача с текущей страницы при нажатии элемента управления LinkButton.The URL of the Web page to post to from the current page when the LinkButton control is clicked. Значение по умолчанию — пустая строка (""), которая приводит к обратной передаче страницы самой себе.The default value is an empty string (""), which causes the page to post back to itself.

Реализации

Атрибуты

Примеры

В следующем примере кода показано, как использовать PostBackUrl свойство для выполнения межстраничной передачи.The following code example demonstrates how to use the PostBackUrl property to perform a cross-page post. Когда пользователь щелкает LinkButton элемент управления, страница отправляет значение, введенное в текстовое поле, на целевую страницу, указанную PostBackUrl свойством.When the user clicks the LinkButton control, the page posts the value entered in the text box to the target page specified by the PostBackUrl property. Для выполнения этого примера необходимо также создать файл для целевой страницы в том же каталоге, что и этот пример кода.To run this sample, you must also create a file for the target page in the same directory as this code example. Код для целевой страницы приведен в следующем примере.The code for the target page is provided in the next example.

Важно!

В этом примере имеется текстовое поле, принимающее вводимые пользователем данные, что является потенциальной угрозой безопасности.This example has a text box that accepts user input, which is a potential security threat. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и HTML-элементов.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.For more information, see Script Exploits Overview.

<%@ 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>LinkButton.PostBackUrl Example</title>
</head>
<body>    
  <form id="form1" runat="server">
    
    <h3>LinkButton.PostBackUrl Example</h3>

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

    <br /><br />

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

    <br /><br />

    <asp:linkbutton id="LinkButton2"
      text="Post value to another page" 
      postbackurl="LinkButton.PostBackUrlPage2cs.aspx" 
      runat="Server">
    </asp:linkbutton>

  </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>LinkButton.PostBackUrl Example</title>
</head>
<body>    
  <form id="form1" runat="server">
    
    <h3>LinkButton.PostBackUrl Example</h3>

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

    <br /><br />

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

    <br /><br />

    <asp:linkbutton id="LinkButton2"
      text="Post value to another page" 
      postbackurl="LinkButton.PostBackUrlPage2vb.aspx" 
      runat="Server">
    </asp:linkbutton>

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

В следующем примере кода показано, как использовать Page.PreviousPage свойство для доступа к значению, отправленному с другой страницы с помощью PostBackUrl Свойства.The following code example demonstrates how to use the Page.PreviousPage property to access a value that was posted from another page using the PostBackUrl property. Эта страница возвращает строку, которая была отправлена с предыдущей страницы, и отображает ее пользователю.This page gets the string that was posted from the previous page and displays it to the user. Если вы попытаетесь выполнить этот пример кода напрямую, возникнет ошибка, так как значение text поля будет равно null .If you attempt to run this code example directly, you will get an error because the value of the text field will be null. Вместо этого используйте этот код, чтобы создать целевую страницу и поместить файл в тот же каталог, что и код предыдущего примера.Instead, use this code to create a target page and place the file in the same directory as the code for the previous example. Имя файла должно соответствовать значению, заданному для PostBackUrl свойства в предыдущем примере.The name of the file must correspond to the value specified for the PostBackUrl property in the previous example. При выполнении кода для предыдущего примера Эта страница будет выполняться автоматически при возникновении межстраничной передачи.When you run the code for the previous example, this page will execute automatically when the cross-page post occurs.

Важно!

В этом примере имеется текстовое поле, принимающее вводимые пользователем данные, что является потенциальной угрозой безопасности.This example has a text box that accepts user input, which is a potential security threat. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и HTML-элементов.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.For more information, see Script Exploits Overview.

<%@ 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>LinkButton.PostBackUrl Target Page Example</title>
</head>
<body>
  <form id="form1" runat="server">
    
    <h3>LinkButton.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>LinkButton.PostBackUrl Target Page Example</title>
</head>
<body>
  <form id="form1" runat="server">
    
    <h3>LinkButton.PostBackUrl Target Page Example</h3>
       
    <br />
    
    <asp:label id="PostedLabel"
       runat="Server">
    </asp:label>

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

Комментарии

PostBackUrlСвойство позволяет выполнять межстраничную запись с помощью LinkButton элемента управления.The PostBackUrl property allows you to perform a cross-page post using the LinkButton control. В качестве значения PostBackUrl Свойства задайте URL веб-страницы для публикации при LinkButton щелчке элемента управления.Set the PostBackUrl property to the URL of the Web page to post to when the LinkButton control is clicked. Например, указание Page2. aspx приводит к тому, что страница, содержащая LinkButton элемент управления, будет отправлена в Page2.aspx .For example, specifying Page2.aspx causes the page that contains the LinkButton control to post to Page2.aspx. Если значение для свойства не задано PostBackUrl , страница отправляется обратно.If you do not specify a value for the PostBackUrl property, the page posts back to itself.

Важно!

При выполнении обратной передачи между страницами с элементами управления с проверкой на стороне сервера IsValid true перед обработкой обратной передачи следует проверить свойство страницы.When performing a cross-page postback with controls with server-side validation, you should check that the page's IsValid property is true before processing the postback. В случае межстраничной передачи данных проверяемая страница является PreviousPage.In the case of a cross-page postback, the page to check is the PreviousPage. В следующем Visual Basic коде показано, как это сделать.The following Visual Basic code shows how this is done:

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.For more information on cross-page posting techniques, see Cross-Page Posting in ASP.NET Web Forms.

Значение для данного свойства нельзя задать с помощью тем или тем таблиц стилей.This property cannot be set by themes or style sheet themes. Дополнительные сведения см. в статьях ThemeableAttribute и ASP.NET Themes и обложки.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Применяется к

См. также раздел