Поделиться через

Button.UseSubmitBehavior Свойство

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Получает или задает значение, указывающее, использует ли элемент управления Button механизм отправки из клиентского браузера или механизм обратной передачи 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

Значение свойства

Boolean

true, если элемент управления использует механизм отправки из клиентского браузера; в противном случае — false. Значение по умолчанию — true.

Атрибуты
ThemeableAttribute

Примеры

В следующем примере кода показано, как использовать UseSubmitBehavior свойство , чтобы указать механизм отправки, используемый элементом Button управления при отправке обратно на сервер. Свойству UseSubmitBehavior присваивается значение false, в результате чего кнопка использует механизм обратной передачи ASP.NET. При просмотре исходного кода для отображаемой страницы с помощью команды "Просмотреть исходный код" в браузере вы увидите, что клиентский скрипт был добавлен платформой ASP.NET страницы для публикации формы на сервере.

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

Комментарии

Используйте свойство , UseSubmitBehavior чтобы указать, использует ли Button элемент управления механизм отправки клиентского браузера или механизм обратной передачи ASP.NET. По умолчанию это свойство имеет trueзначение , в результате чего Button элемент управления будет использовать механизм отправки в браузере. Если указать false, платформа страницы ASP.NET добавляет клиентский скрипт на страницу для отправки формы на сервер.

UseSubmitBehavior Если свойство имеет значение false, разработчики элементов управления могут использовать GetPostBackEventReference метод для возврата события обратной передачи Buttonклиента для . Строка, возвращаемая методом GetPostBackEventReference , содержит текст вызова функции на стороне клиента и может быть вставлена в обработчик событий на стороне клиента.

Значение для данного свойства нельзя задать с помощью тем или тем таблиц стилей. Дополнительные сведения см. в разделе ThemeableAttribute и ASP.NET темы и обложки.

Применяется к

См. также раздел