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 темы и обложки.

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

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