HtmlForm.DefaultButton Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает дочерний элемент управления, принадлежащий элементу управления HtmlForm, который вызывает обратную передачу данных, когда нажимается клавиша ENTER.
public:
property System::String ^ DefaultButton { System::String ^ get(); void set(System::String ^ value); };public string DefaultButton { get; set; }member this.DefaultButton : string with get, setPublic Property DefaultButton As StringЗначение свойства
Свойство ID элемента управления "кнопка" для отображения в виде кнопки по умолчанию при загрузке объекта HtmlForm. Значение по умолчанию — пустая строка.
Исключения
Элемент управления, упоминаемый как "кнопка", не принадлежит типу IButtonControl.
Примеры
В следующем примере показано, как задать DefaultButton свойство , чтобы задать элемент управления по умолчанию, который вызывает обратную передачу.
<%@ 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 Page_Load(object sender, System.EventArgs e)
{
// Set the text of the two label controls.
Label1.Text = "The DefaultButton property is set to "
+ Form1.DefaultButton.ToString() + "<br/>";
Label2.Text = "The DefaultFocus property is set to "
+ Form1.DefaultFocus.ToString();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlForm DefaultButton and DefaultFocus Properties Example</title>
</head>
<body>
<form id="Form1"
defaultbutton="SubmitButton"
defaultfocus="TextBox1"
runat="server">
<h3>HtmlForm DefaultButton and DefaultFocus Properties Example</h3>
TextBox1:
<asp:textbox id="TextBox1"
autopostback="true"
runat="server">
</asp:textbox>
<br />
TextBox2:
<asp:textbox id="TextBox2"
autopostback="true"
runat="server">
</asp:textbox>
<br /><br />
<asp:button id="SubmitButton"
text="Submit"
runat="server">
</asp:button>
<asp:button id="CancelButton"
text="Cancel"
runat="server">
</asp:button>
<hr />
<asp:label id="Label1"
runat="Server">
</asp:label>
<asp:label id="Label2"
runat="Server">
</asp:label>
</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 Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
' Set the text of the two label controls.
Label1.Text = "The DefaultButton property is set to " _
& Form1.DefaultButton.ToString & "<br/>"
Label2.Text = "The DefaultFocus property is set to " _
& Form1.DefaultFocus.ToString
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlForm DefaultButton and DefaultFocus Properties Example</title>
</head>
<body>
<form id="Form1"
defaultbutton="SubmitButton"
defaultfocus="TextBox1"
runat="server">
<h3>HtmlForm DefaultButton and DefaultFocus Properties Example</h3>
TextBox1:
<asp:textbox id="TextBox1"
autopostback="true"
runat="server">
</asp:textbox>
<br />
TextBox2:
<asp:textbox id="TextBox2"
autopostback="true"
runat="server">
</asp:textbox>
<br /><br />
<asp:button id="SubmitButton"
text="Submit"
runat="server">
</asp:button>
<asp:button id="CancelButton"
text="Cancel"
runat="server">
</asp:button>
<hr />
<asp:label id="Label1"
runat="Server">
</asp:label>
<asp:label id="Label2"
runat="Server">
</asp:label>
</form>
</body>
</html>
Комментарии
Свойство DefaultButton позволяет указать, что пользователи могут вызвать обратную передачу, нажав клавишу ВВОД в элементе управления ввода в форме (например, в текстовом поле). В качестве кнопки по умолчанию можно указать любой элемент управления, производный IButtonControl от интерфейса, за исключением LinkButton элемента управления . Если элемент управления, на который ссылается свойство , не является производным DefaultButtonInvalidOperationException от IButtonControl, создается исключение.
Если вы используете главные страницы и задаете DefaultButton свойство на странице содержимого, используйте UniqueID свойство кнопки IButtonControl . Дополнительные сведения о главных страницах см. в разделе ASP.NET главные страницы.
Свойство DefaultButton может не вызывать обратную передачу в следующих сценариях:
Нажатие клавиши ВВОД, когда фокус находится за пределами элементов управления вводом в форме. Действие обратной передачи по умолчанию не будет активировано.
Нажатие клавиши ВВОД, когда фокус находится внутри многострочного текстового поля. В многострочном текстовом поле ожидаемое поведение заключается в том, что нажатие клавиши ВВОД создает новую строку в текстовом поле. В некоторых браузерах нажатие клавиши ВВОД внутри многострочного текстового поля вызывает обратную передачу. В этом случае, если вы хотите, чтобы ввод создавал новую строку, вы можете присоединить функцию JavaScript к элементу управления вводом. Скрипт должен записать клавишу ВВОД и остановить обратную передачу. Например, можно использовать коллекцию Attributes свойств для добавления клиентского скрипта
onKeyPressдля события.Указание элемента управления в LinkButton качестве кнопки по умолчанию. Поддерживаются только Button элементы управления и ImageButton .
DefaultButton Изменение свойства программным способом во время асинхронной обратной передачи. Асинхронную обратную передачу можно включить на странице, добавив один или несколько UpdatePanel элементов управления на страницу. Дополнительные сведения см. в разделах Обзор элемента управления UpdatePanel и Обзор частичной отрисовки страниц.
