Button.UseSubmitBehavior Tulajdonság

Definíció

Lekéri vagy beállít egy értéket, amely jelzi, hogy a Button vezérlő az ügyfélböngésző küldési mechanizmusát vagy a ASP.NET postback mechanizmust használja-e.

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

Tulajdonság értéke

trueha a vezérlő az ügyfélböngésző küldési mechanizmusát használja; egyéb esetben. false Az alapértelmezett érték a true.

Attribútumok

Példák

Az alábbi példakód bemutatja, hogyan használható a tulajdonság a UseSubmitBehavior vezérlő által a kiszolgálóra való visszatéréskor használt küldési mechanizmus Button megadására. A UseSubmitBehavior tulajdonság értéke false, így a gomb a ASP.NET postback mechanizmust használja. Ha a böngésző Forrás megtekintése parancsával tekinti meg a renderelt oldal forráskódját, látni fogja, hogy az ügyféloldali szkriptet hozzáadta a ASP.NET lap keretrendszere az űrlap kiszolgálóra való közzétételéhez.

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

Megjegyzések

A UseSubmitBehavior tulajdonság segítségével megadhatja, hogy egy Button vezérlő az ügyfélböngésző küldési mechanizmusát vagy a ASP.NET postback mechanizmust használja-e. Alapértelmezés szerint ennek a tulajdonságnak az értéke az true, ami miatt a Button vezérlő a böngésző küldési mechanizmusát használja. Ha false ad meg, a ASP.NET lap keretrendszere ügyféloldali szkriptet ad hozzá a laphoz, hogy közzétehesse az űrlapot a kiszolgálón.

Ha a UseSubmitBehavior tulajdonság az false, a vezérlőfejlesztők a GetPostBackEventReference metódus használatával visszaadhatják a visszaküldött ügyféleseményt a Button. A metódus által visszaadott sztring GetPostBackEventReference tartalmazza az ügyféloldali függvényhívás szövegét, és beszúrható egy ügyféloldali eseménykezelőbe.

Ez a tulajdonság nem állítható be témák vagy stíluslaptémák szerint. További információ: ThemeableAttribute és ASP.NET Témák és bőrök.

A következőre érvényes:

Lásd még