HtmlForm.DefaultButton HtmlForm.DefaultButton HtmlForm.DefaultButton HtmlForm.DefaultButton Property

Определение

Возвращает или задает дочерний элемент управления, принадлежащий элементу управления HtmlForm, который вызывает обратную передачу данных, когда нажимается клавиша ENTER.Gets or sets the child control of the HtmlForm control that causes postback when the ENTER key is pressed.

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

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

Свойство ID элемента управления "кнопка" для отображения в виде кнопки по умолчанию при загрузке объекта HtmlForm.The ID of the button control to display as the default button when the HtmlForm is loaded. Значением по умолчанию является пустая строка ("").The default value is an empty string ("").

Исключения

Элемент управления, упоминаемый как "кнопка", не принадлежит типу IButtonControl.The control referenced as the default button is not of the type IButtonControl.

Примеры

В следующем примере показано, как задать DefaultButton свойство, чтобы задать элемент управления по умолчанию, который вызывает обратную передачу.The following example shows how to set the DefaultButton property to set the default control that causes a postback.

<%@ 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 Свойство позволяет указать, что пользователи могут вызвать обратную передачу, нажав клавишу ВВОД в элементе управления вводом в форме (например, в текстовом поле).The DefaultButton property lets you specify that users can cause a postback by pressing ENTER in an input control in the form (such as a text box). Можно указать в качестве кнопки по умолчанию любой элемент управления, производный IButtonControl от интерфейса, LinkButton Кроме элемента управления.You can specify as a default button any control that derives from the IButtonControl interface except the LinkButton control. Если элемент управления, на который ссылается DefaultButton свойство, не является производным от IButtonControl, InvalidOperationException создается исключение.If the control that is referenced by the DefaultButton property does not derive from IButtonControl, an InvalidOperationException exception is thrown.

Если вы используете главные страницы и задаете DefaultButton свойство на странице содержимого, UniqueID используйте свойство IButtonControl кнопки.If you are using master pages and you set the DefaultButton property from a content page, use the UniqueID property of the IButtonControl button. Дополнительные сведения о главных страницах см. в разделе ASP.NET Master Pages.For more information about master pages, see ASP.NET Master Pages.

DefaultButton Свойство может не вызывать обратную передачу в следующих сценариях:The DefaultButton property might not cause a postback in the following scenarios:

  • Нажатие клавиши ВВОД, если фокус находится за пределами элементов управления вводом в форме.Pressing ENTER when focus is outside the input controls in the form. Действие обратной передачи по умолчанию не гарантирует срабатывание.The default postback action is not guaranteed to be triggered.

  • Нажмите клавишу ВВОД, когда фокус находится внутри многострочного текстового поля.Pressing ENTER when focus is inside a multi-line text box. В многострочном текстовом поле ожидаемое поведение заключается в том, что нажатие клавиши ВВОД создает новую строку в текстовом поле.In a multi-line text box, the expected behavior is that pressing ENTER creates a new line in the text box. В некоторых браузерах при нажатии клавиши Ввод внутри многострочного текстового поля активируется обратная передача.In some browsers, pressing ENTER inside a multi-line text box triggers a postback. В этом случае, если нужно создать новую строку вместо этого, можно присоединить функцию JavaScript к элементу управления вводом.In that case, if you want ENTER to create a new line instead, you can attach a JavaScript function to the input control. Скрипт должен записать клавишу ВВОД и прерывать обратную передачу.The script should capture the ENTER key and stop the postback. Например, можно использовать Attributes коллекцию свойств, чтобы добавить клиентский скрипт onKeyPress для события.For example, you can use the Attributes property collection to add client script for the onKeyPress event.

  • LinkButton Указание элемента управления в качестве кнопки по умолчанию.Specifying a LinkButton control as a default button. Button Поддерживаются ImageButton только элементы управления и.Only Button and ImageButton controls are supported.

  • Программное DefaultButton изменение свойства во время асинхронной обратной передачи.Changing the DefaultButton property programmatically during an asynchronous postback. Асинхронные обратные передачи можно включить на странице, добавив на страницу один UpdatePanel или несколько элементов управления.Asynchronous postbacks can be enabled on a page by adding one or more UpdatePanel controls to the page. Дополнительные сведения см. в разделе Общие сведения об элементе управления UpdatePanel и Общие сведения о частичной отрисовке страниц.For more information, see UpdatePanel Control Overview and Partial-Page Rendering Overview.

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

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