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

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 темы и скины.

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

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