Button.UseSubmitBehavior Eigenschaft

Definition

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.Gets or sets a value indicating whether the Button control uses the client browser's submit mechanism or the ASP.NET postback mechanism.

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

Eigenschaftswert

true, wenn das Steuerelement den Sendemechanismus des Clientbrowsers verwendet, andernfalls false.true if the control uses the client browser's submit mechanism; otherwise, false. Die Standardeinstellung ist true.The default is true.

Attribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die UseSubmitBehavior -Eigenschaft verwendet wird, um den Sende Button Mechanismus anzugeben, der von einem-Steuerelement beim Zurücksenden an den Server verwendet wird.The following code example demonstrates how to use the UseSubmitBehavior property to specify the submit mechanism that a Button control uses when it posts back to the server. Die UseSubmitBehavior -Eigenschaft ist auf falsefestgelegt, sodass die Schaltfläche den ASP.net Post Back-Mechanismus verwendet.The UseSubmitBehavior property is set to false, causing the button to use the ASP.NET postback mechanism. Wenn Sie den Quellcode für die gerenderte Seite mithilfe des Befehls Quelle anzeigen des Browsers anzeigen, sehen Sie, dass das Client seitige Skript vom ASP.net page Framework hinzugefügt wurde, um das Formular an den Server zu senden.If you view the source code for the rendered page using your browser's View Source command, you will see that client-side script has been added by the ASP.NET page framework to post the form to the server.

<%@ 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 UseSubmitBehavior die-Eigenschaft, um Button anzugeben, ob ein-Steuerelement den Sende Mechanismus des Client Browsers oder den ASP.net Post Back-Mechanismus verwendet.Use the UseSubmitBehavior property to specify whether a Button control uses the client browser's submit mechanism or the ASP.NET postback mechanism. Standardmäßig ist trueder Wert dieser Eigenschaft, was bewirkt, Button dass das Steuerelement den Sende Mechanismus des Browsers verwendet.By default the value of this property is true, causing the Button control to use the browser's submit mechanism. Wenn Sie angeben false, fügt das ASP.net page Framework der Seite ein Client seitiges Skript hinzu, um das Formular an den Server zu senden.If you specify false, the ASP.NET page framework adds client-side script to the page to post the form to the server.

Wenn die UseSubmitBehavior -Eigenschaft falseist, können Entwickler von GetPostBackEventReference Steuerelementen die-Methode verwenden, um das Client Postback-Ereignis für das Buttonzurückzugeben.When the UseSubmitBehavior property is false, control developers can use the GetPostBackEventReference method to return the client postback event for the Button. Die Zeichenfolge, die GetPostBackEventReference von der-Methode zurückgegeben wird, enthält den Text des Client seitigen Funktions Aufrufes und kann in einen Client seitigen Ereignishandler eingefügt werden.The string returned by the GetPostBackEventReference method contains the text of the client-side function call and can be inserted into a client-side event handler.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden.This property cannot be set by themes or style sheet themes. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Gilt für:

Siehe auch