HtmlForm.DefaultButton Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает дочерний элемент управления HtmlForm , который вызывает обратную передачу при нажатии клавиши ВВОД.
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 элемента управления. Если элемент управления, на который ссылается свойство, не является производнымDefaultButton, IButtonControlInvalidOperationException создается исключение.
Если вы используете главные страницы и задаете DefaultButton свойство на странице содержимого, используйте UniqueID свойство кнопки IButtonControl . Дополнительные сведения о главных страницах см. в ASP.NET главных страницах.
Свойство DefaultButton может не вызвать обратную передачу в следующих сценариях:
Нажатие клавиши ВВОД, когда фокус находится вне входных элементов управления в форме. Действие обратной передачи по умолчанию не гарантируется.
При нажатии клавиши ВВОД при расположении фокуса внутри текстового поля с несколькими строками. В текстовом поле с несколькими строками ожидаемое поведение заключается в том, что нажатие клавиши ВВОД создает новую строку в текстовом поле. В некоторых браузерах нажатие клавиш ВВОД внутри многострочного текстового поля активирует обратную передачу. В этом случае, если вы хотите создать новую строку, можно подключить функцию JavaScript к элементу управления ввода. Скрипт должен записать клавишу ВВОД и остановить обратную передачу. Например, коллекцию Attributes свойств можно использовать для добавления клиентского скрипта
onKeyPressдля события.Указание LinkButton элемента управления в качестве кнопки по умолчанию. Поддерживаются только Button элементы ImageButton управления.
DefaultButton Изменение свойства программным способом во время асинхронной обратной передачи. Асинхронные обратные передачи можно включить на странице, добавив один или несколько UpdatePanel элементов управления на страницу. Дополнительные сведения см. в разделе "Обзор элемента управления UpdatePanel" и обзорPartial-Page отрисовки.
