Freigeben über

Button.PostBackUrl Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ruft die URL der Seite ab, an die Daten von der aktuellen Seite gesendet werden sollen, wenn auf das Button-Steuerelement geklickt wird, oder legt diese fest.

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

Eigenschaftswert

String

Die URL der Webseite, an die Daten von der aktuellen Seite gesendet werden sollen, wenn auf das Button-Steuerelement geklickt wird. Der Standardwert ist eine leere Zeichenfolge (""), wodurch die Seite an sich selbst zurückgesendet wird.

Implementiert

PostBackUrl
Attribute
ThemeableAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die PostBackUrl -Eigenschaft zum Ausführen eines seitenübergreifenden Beitrags verwendet wird. Wenn der Benutzer auf das Button Steuerelement klickt, stellt die Seite den im Textfeld eingegebenen Wert an die zielseite, die von der PostBackUrl -Eigenschaft angegeben wird. Zum Ausführen dieses Beispiels müssen Sie auch eine Datei für die Zielseite im selben Verzeichnis wie dieses Codebeispiel erstellen. Der Code für die Zielseite wird im nächsten Beispiel bereitgestellt.

<%@ 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>

Im folgenden Codebeispiel wird veranschaulicht, wie die Page.PreviousPage -Eigenschaft verwendet wird, um auf einen Wert zuzugreifen, der von einer anderen Seite mithilfe der PostBackUrl -Eigenschaft bereitgestellt wurde. Diese Seite ruft die Zeichenfolge ab, die von der vorherigen Seite gepostet wurde, und zeigt sie dem Benutzer an. Wenn Sie versuchen, dieses Codebeispiel direkt auszuführen, erhalten Sie einen Fehler, da der Wert des text Felds lautet null. Verwenden Sie stattdessen diesen Code, um eine Zielseite zu erstellen und die Datei im selben Verzeichnis wie der Code für das vorherige Beispiel zu platzieren. Der Name der Datei muss dem Wert entsprechen, der im vorherigen Beispiel für die PostBackUrl -Eigenschaft angegeben wurde. Wenn Sie den Code für das vorherige Beispiel ausführen, wird diese Seite automatisch ausgeführt, wenn der seitenübergreifende Beitrag auftritt.

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.

<%@ 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>

Hinweise

Mit PostBackUrl der -Eigenschaft können Sie mithilfe des Button -Steuerelements einen seitenübergreifenden Beitrag ausführen.

Hinweis

Nur ordnungsgemäß angegebene Pfade funktionieren mit dieser Eigenschaft. Relative Pfade (Test/default.aspx), absolute Pfade (https://localhost/WebApp/default.aspx) und virtuelle (~\Test\default.aspx) funktionieren beispielsweise ordnungsgemäß. Falsch formatierte Pfade wie "/Test/default.aspx" oder "\Test\default.aspx" funktionieren nicht. Unter ASP.NET Webprojektpfade finden Sie eine Diskussion zum Erstellen korrekter Pfade.

Legen Sie die PostBackUrl -Eigenschaft auf die URL der Webseite fest, die beim Klicken auf das Button Steuerelement gepostet werden soll. Wenn Sie z. B. angeben Page2.aspx , wird die Seite, die das Button -Steuerelement enthält, in gepostet Page2.aspx. Wenn Sie keinen Wert für die PostBackUrl Eigenschaft angeben, wird die Seite auf sich selbst zurückkommen.

Wichtig

Wenn Sie ein seitenübergreifendes Postback mit Steuerelementen mit serverseitiger Validierung durchführen, sollten Sie vor der Verarbeitung des Postbacks IsValid überprüfen, ob die -Eigenschaft der Seite ist true . Im Fall eines seitenübergreifenden Postbacks ist die zu überprüfende Seite .PreviousPage Der folgende VB-Code zeigt, wie dies geschieht:

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

Weitere Informationen zu techniken für die seitenübergreifende Veröffentlichung finden Sie unter Cross-Page Posting in ASP.NET Web Forms.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.

Gilt für:

Weitere Informationen