Sdílet prostřednictvím

Button.UseSubmitBehavior Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá nebo nastaví hodnotu označující, zda Button ovládací prvek používá mechanismus odeslání klientského prohlížeče nebo mechanismus ASP.NET postback.

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

Hodnota vlastnosti

Boolean

truepokud ovládací prvek používá mechanismus odesílání v klientském prohlížeči; v opačném případě . false Výchozí formát je true.

Atributy
ThemeableAttribute

Příklady

Následující příklad kódu ukazuje, jak použít UseSubmitBehavior vlastnost k určení mechanismu odeslání, který Button ovládací prvek používá při odeslání zpět na server. Vlastnost UseSubmitBehavior je nastavena na false, což způsobí, že tlačítko použije mechanismus ASP.NET postback. Pokud zobrazíte zdrojový kód vykreslené stránky pomocí příkazu Zobrazit zdroj v prohlížeči, uvidíte, že rozhraní stránky ASP.NET přidalo skript na straně klienta pro odeslání formuláře na 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>

Poznámky

UseSubmitBehavior Pomocí vlastnosti určete, jestli Button ovládací prvek používá mechanismus odeslání v klientském prohlížeči nebo mechanismus ASP.NET zpětného odeslání. Ve výchozím nastavení je truehodnota této vlastnosti , což způsobuje Button , že ovládací prvek používá mechanismus odesílání prohlížeče. Pokud zadáte false, rozhraní stránky ASP.NET přidá na stránku skript na straně klienta, který formulář publikuje na server.

Pokud je falsevlastnost , můžou vývojáři ovládacích prvků použít metodu GetPostBackEventReference k vrácení události postback klienta pro Button.UseSubmitBehavior Řetězec vrácený metodou GetPostBackEventReference obsahuje text volání funkce na straně klienta a může být vložen do obslužné rutiny události na straně klienta.

Tuto vlastnost nelze nastavit pomocí motivů nebo šablon stylů. Další informace najdete v tématu ThemeableAttribute a ASP.NET motivy a vzhledy.

Platí pro

Viz také