Button.UseSubmitBehavior Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar eller anger ett värde som anger om Button-kontrollen använder klientwebbläsarens sändningsmekanism eller ASP.NET efteråterställningsmekanism.

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

Egenskapsvärde

Boolean

trueom kontrollen använder klientwebbläsarens sändningsmekanism; annars . false Standardvärdet är true.

Attribut
ThemeableAttribute

Exempel

Följande kodexempel visar hur du använder UseSubmitBehavior egenskapen för att ange den sändningsmekanism som en Button kontroll använder när den skickas tillbaka till servern. Egenskapen UseSubmitBehavior är inställd på false, vilket gör att knappen använder mekanismen ASP.NET postback. Om du visar källkoden för den renderade sidan med hjälp av webbläsarens View Source-kommando ser du att skriptet på klientsidan har lagts till av det ASP.NET sidramverket för att publicera formuläret på servern.

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

Kommentarer

Använd egenskapen UseSubmitBehavior för att ange om en Button-kontroll använder klientwebbläsarens sändningsmekanism eller mekanismen ASP.NET postback. Som standard är truevärdet för den här egenskapen , vilket gör Button att kontrollen använder webbläsarens sändningsmekanism. Om du anger false lägger ASP.NET-sidramverket till skript på klientsidan på sidan för att publicera formuläret på servern.

När egenskapen UseSubmitBehavior är falsekan kontrollutvecklare använda GetPostBackEventReference metoden för att returnera klientpostback-händelsen för Button. Strängen GetPostBackEventReference som returneras av metoden innehåller texten i funktionsanropet på klientsidan och kan infogas i en händelsehanterare på klientsidan.

Den här egenskapen kan inte anges med teman eller formatmallsteman. Mer information finns i ThemeableAttribute and ASP.NET Themes and Skins.

Gäller för

Se även