Udostępnij za pośrednictwem


Button.UseSubmitBehavior Właściwość

Definicja

Pobiera lub ustawia wartość wskazującą, czy Button kontrolka używa mechanizmu przesyłania przeglądarki klienta, czy mechanizmu ASP.NET wycofywania.

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

Wartość właściwości

true jeśli kontrolka używa mechanizmu przesyłania przeglądarki klienta; w przeciwnym razie , false. Wartość domyślna to true.

Atrybuty

Przykłady

W poniższym przykładzie kodu pokazano, jak użyć UseSubmitBehavior właściwości w celu określenia mechanizmu przesyłania, który Button jest używany przez kontrolkę, gdy publikuje z powrotem na serwerze. Właściwość jest ustawiona UseSubmitBehavior na falsewartość , powodując, że przycisk używa mechanizmu ASP.NET wycofywania. Jeśli wyświetlisz kod źródłowy renderowanej strony przy użyciu polecenia Wyświetl źródło przeglądarki, zobaczysz, że skrypt po stronie klienta został dodany przez platformę strony ASP.NET, aby opublikować formularz na serwerze.

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

Uwagi

UseSubmitBehavior Użyj właściwości , aby określić, czy Button kontrolka używa mechanizmu przesyłania przeglądarki klienta, czy mechanizmu ASP.NET wycofywania. Domyślnie wartość tej właściwości to true, powodując, że Button kontrolka używa mechanizmu przesyłania przeglądarki. Jeśli określisz falsewartość , struktura strony ASP.NET dodaje skrypt po stronie klienta do strony, aby opublikować formularz na serwerze.

UseSubmitBehavior Gdy właściwość to false, deweloperzy mogą użyć GetPostBackEventReference metody , aby zwrócić zdarzenie po powrocie klienta dla Buttonelementu . Ciąg zwrócony przez GetPostBackEventReference metodę zawiera tekst wywołania funkcji po stronie klienta i można go wstawić do procedury obsługi zdarzeń po stronie klienta.

Nie można ustawić tej właściwości według motywów ani motywów arkusza stylów. Aby uzyskać więcej informacji, zobacz ThemeableAttributei ASP.NET Motywy i skóry.

Dotyczy

Zobacz też