Button.UseSubmitBehavior Свойство

Определение

Получает или задает значение, указывающее, использует ли элемент управления Button механизм отправки из клиентского браузера или механизм обратной передачи ASP.NET.Gets or sets a value indicating whether the Button control uses the client browser's submit mechanism or the ASP.NET postback mechanism.

public:
 virtual property bool UseSubmitBehavior { bool get(); void set(bool value); };
[System.Web.UI.Themeable(false)]
public virtual bool UseSubmitBehavior { get; set; }
member this.UseSubmitBehavior : bool with get, set
Public Overridable Property UseSubmitBehavior As Boolean

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

true, если элемент управления использует механизм отправки из клиентского браузера; в противном случае — false.true if the control uses the client browser's submit mechanism; otherwise, false. Значение по умолчанию — true.The default is true.

Атрибуты

Примеры

В следующем примере кода показано UseSubmitBehavior Button , как использовать свойство для указания механизма отправки, который элемент управления использует при обратной передаче на сервер.The following code example demonstrates how to use the UseSubmitBehavior property to specify the submit mechanism that a Button control uses when it posts back to the server. UseSubmitBehavior Свойство имеетfalseзначение, в результате чего кнопка будет использовать механизм обратной передачи ASP.NET.The UseSubmitBehavior property is set to false, causing the button to use the ASP.NET postback mechanism. Если вы просматриваете исходный код для подготовленной страницы с помощью команды просмотра исходного кода браузера, вы увидите, что клиентский сценарий добавлен платформой ASP.NET Page Framework для публикации формы на сервере.If you view the source code for the rendered page using your browser's View Source command, you will see that client-side script has been added by the ASP.NET page framework to post the form to the 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>

Комментарии

Используйте свойство, чтобы указать, использует Button ли элемент управления механизм отправки клиентского браузера или механизм обратной передачи ASP.NET. UseSubmitBehaviorUse the UseSubmitBehavior property to specify whether a Button control uses the client browser's submit mechanism or the ASP.NET postback mechanism. По умолчанию значение этого свойства равно true, в Button результате чего элемент управления должен использовать механизм отправки в браузере.By default the value of this property is true, causing the Button control to use the browser's submit mechanism. Если указать false, платформа ASP.NET страницы добавит клиентский скрипт на страницу для публикации формы на сервере.If you specify false, the ASP.NET page framework adds client-side script to the page to post the form to the server.

Если свойство имеет falseзначение, разработчики GetPostBackEventReference элементов управления могут использовать метод, Buttonчтобы вернуть клиентское событие обратной передачи для. UseSubmitBehaviorWhen the UseSubmitBehavior property is false, control developers can use the GetPostBackEventReference method to return the client postback event for the Button. Строка, возвращаемая GetPostBackEventReference методом, содержит текст вызова функции на стороне клиента и может быть вставлена в обработчик событий на стороне клиента.The string returned by the GetPostBackEventReference method contains the text of the client-side function call and can be inserted into a client-side event handler.

Значение для данного свойства нельзя задать с помощью тем или тем таблиц стилей.This property cannot be set by themes or style sheet themes. Дополнительные сведения см ThemeableAttribute . в статьях и ASP.NET Themes и обложки.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

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

Дополнительно