Button.UseSubmitBehavior Eigenschaft

  • Referenz

Definition

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

Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob das Button-Steuerelement den Sendemechanismus des Clientbrowsers oder den Postbackmechanismus von ASP.NET verwendet.

public:
 virtual property bool UseSubmitBehavior { bool get(); void set(bool value); };
[System.Web.UI.Themeable(false)]
public virtual bool UseSubmitBehavior { get; set; }
[<System.Web.UI.Themeable(false)>]
member this.UseSubmitBehavior : bool with get, set
Public Overridable Property UseSubmitBehavior As Boolean

Eigenschaftswert

Boolean

true, wenn das Steuerelement den Sendemechanismus des Clientbrowsers verwendet, andernfalls false. Der Standardwert ist true.

Attribute
ThemeableAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die UseSubmitBehavior Eigenschaft verwenden, um den Übermittlungsmechanismus anzugeben, den ein Button Steuerelement verwendet, wenn es zurück zum Server veröffentlicht wird. Die UseSubmitBehavior Eigenschaft wird auf falsefestgelegt, wodurch die Schaltfläche den ASP.NET Postbackmechanismus verwendet. Wenn Sie den Quellcode für die gerenderte Seite mithilfe des Befehls "Quellansicht" des Browsers anzeigen, wird angezeigt, dass clientseitige Skripts vom ASP.NET Seitenframework hinzugefügt wurden, um das Formular auf dem Server zu posten.

<%@ 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 SubmitBtn_Click(object sender, EventArgs e)
  {
    Message.Text = "Hello World!";    
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
  <title>Button.UseSubmitBehavior Example</title>
</head>
<body>
  <form id="form1" runat="server">

    <h3>Button.UseSubmitBehavior Example</h3> 

    Click the Submit button.
     
    <br /><br /> 

    <!--The value of the UseSubmitBehavior property
    is false. Therefore the button uses the ASP.NET 
    postback mechanism.-->
    <asp:button id="Button1"
      text="Submit"
      onclick="SubmitBtn_Click" 
      usesubmitbehavior="false"
      runat="server"/>       

    <br /><br /> 

    <asp:label id="Message" 
      runat="server"/>

  </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 SubmitBtn_Click(ByVal sender As Object, ByVal e As EventArgs)
    
    Message.Text = "Hello World!"
    
  End Sub

  </script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
  <title>Button.UseSubmitBehavior Example</title>
</head>
<body>
  <form id="form1" runat="server">

    <h3>Button.UseSubmitBehavior Example</h3> 

    Click the Submit button.
      
    <br /><br /> 

    <!--The value of the UseSubmitBehavior property
    is false. Therefore the button uses the ASP.NET 
    postback mechanism.-->
    <asp:button id="Button1"
      text="Submit"
      onclick="SubmitBtn_Click" 
      usesubmitbehavior="false"
      runat="server"/>       

    <br /><br /> 

    <asp:label id="Message" 
      runat="server"/>

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

Hinweise

Verwenden Sie die UseSubmitBehavior Eigenschaft, um anzugeben, ob ein Button Steuerelement den Übermittlungsmechanismus des Clientbrowsers oder den ASP.NET Postbackmechanismus verwendet. Standardmäßig ist trueder Wert dieser Eigenschaft , wodurch das Steuerelement den Button Übermittlungsmechanismus des Browsers verwendet. Wenn Sie angebenfalse, fügt das ASP.NET Seitenframework clientseitiges Skript zur Seite hinzu, um das Formular auf dem Server zu posten.

Wenn die UseSubmitBehavior Eigenschaft lautet false, können Steuerelemententwickler die GetPostBackEventReference Methode verwenden, um das Client-Postbackereignis für das ButtonEreignis zurückzugeben. Die von der GetPostBackEventReference Methode zurückgegebene Zeichenfolge enthält den Text des clientseitigen Funktionsaufrufs und kann in einen clientseitigen Ereignishandler eingefügt werden.

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

Siehe auch