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í prohlížeče klienta nebo mechanismus zpětného odeslání ASP.NET.

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 je nastavená UseSubmitBehavior na falsehodnotu , což způsobí, že tlačítko použije mechanismus zpětného odeslání ASP.NET. 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, který odešle formulář 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í prohlížeče klienta nebo mechanismus zpětného odeslání ASP.NET. 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í ASP.NET stránky přidá na stránku skript na straně klienta pro odeslání formuláře 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 skiny.

Platí pro

Viz také