Button.UseSubmitBehavior Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает значение, указывающее, использует ли элемент управления 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, setPublic Overridable Property UseSubmitBehavior As BooleanЗначение свойства
true, если элемент управления использует механизм отправки из клиентского браузера; в противном случае — false. Значение по умолчанию — true.
- Атрибуты
Примеры
В следующем примере кода показано, как использовать 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 темы и обложки.
