Button.UseSubmitBehavior Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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 die UseSubmitBehavior -Eigenschaft verwendet wird, um den Übermittlungsmechanismus anzugeben, den ein Button Steuerelement verwendet, wenn es an den Server zurückgibt. Die UseSubmitBehavior -Eigenschaft ist auf falsefestgelegt, wodurch die Schaltfläche den ASP.NET Postbackmechanismus verwendet. Wenn Sie den Quellcode für die gerenderte Seite mithilfe des Befehls Quelle anzeigen Ihres Browsers anzeigen anzeigen, sehen Sie, dass das clientseitige Skript vom ASP.NET Seitenframework hinzugefügt wurde, um das Formular auf dem Server zu veröffentlichen.

<%@ 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 Button Steuerelement den Übermittlungsmechanismus des Browsers verwendet. Wenn Sie angeben false, fügt das ASP.NET Seitenframework der Seite ein clientseitiges Skript hinzu, um das Formular auf dem Server zu posten.

Wenn die UseSubmitBehavior -Eigenschaft ist false, können Steuerelemententwickler die GetPostBackEventReference -Methode verwenden, um das Client-Postbackereignis für zurückzugeben Button. 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:

Freigeben über