HtmlForm.DefaultButton Свойство

  • Ссылка

Определение

Пространство имен:
System.Web.UI.HtmlControls
Сборка:
System.Web.dll

Возвращает или задает дочерний элемент управления, принадлежащий элементу управления 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, set
Public Property DefaultButton As String

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

String

Свойство ID элемента управления "кнопка" для отображения в виде кнопки по умолчанию при загрузке объекта HtmlForm. Значение по умолчанию — пустая строка.

Исключения

InvalidOperationException

Элемент управления, упоминаемый как "кнопка", не принадлежит типу 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 и Обзор частичной отрисовки страницы.

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

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