다음을 통해 공유

HtmlForm.DefaultButton 속성

  • 참조

정의

네임스페이스:
System.Web.UI.HtmlControls
어셈블리:
System.Web.dll

Enter 키를 누르면 다시 게시를 발생시키는 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, 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 속성을 사용하면 입력란과 같은 폼의 입력 컨트롤에서 Enter 키를 눌러 사용자가 포스트백을 발생시킬 수 있도록 지정할 수 있습니다. 컨트롤을 제외한 인터페이스에서 파생되는 모든 컨트롤을 IButtonControl 기본 단추로 LinkButton 지정할 수 있습니다. 속성에서 참조 DefaultButton 하는 컨트롤이 에서 IButtonControl파생되지 않으면 예외가 InvalidOperationException throw됩니다.

마스터 페이지를 사용하고 콘텐츠 페이지에서 속성을 설정하는 DefaultButton 경우 단추의 UniqueIDIButtonControl 속성을 사용합니다. 마스터 페이지에 대한 자세한 내용은 마스터 페이지 ASP.NET 참조하세요.

속성은 DefaultButton 다음 시나리오에서 포스트백을 발생시키지 않을 수 있습니다.

  • 폼의 입력 컨트롤 외부에 포커스가 있을 때 Enter 키를 누릅니다. 기본 포스트백 동작은 트리거되지 않습니다.

  • 포커스가 여러 줄 텍스트 상자 안에 있을 때 Enter 키를 누릅니다. 여러 줄 텍스트 상자에서 예상되는 동작은 Enter 키를 누르면 텍스트 상자에 새 줄이 만들어지는 것입니다. 일부 브라우저에서 여러 줄 텍스트 상자 내에서 Enter 키를 누르면 포스트백이 트리거됩니다. 이 경우 Enter 키를 눌러 새 줄을 만들려면 JavaScript 함수를 입력 컨트롤에 연결할 수 있습니다. 스크립트는 ENTER 키를 캡처하고 포스트백을 중지해야 합니다. 예를 들어 속성 컬렉션을 사용하여 Attributes 이벤트에 대한 클라이언트 스크립트를 onKeyPress 추가할 수 있습니다.

  • 컨트롤을 LinkButton 기본 단추로 지정합니다. 및 ImageButton 컨트롤만 Button 지원됩니다.

  • DefaultButton 비동기 포스트백 중에 프로그래밍 방식으로 속성을 변경합니다. 페이지에 하나 이상의 UpdatePanel 컨트롤을 추가하여 페이지에서 비동기 포스트백을 사용하도록 설정할 수 있습니다. 자세한 내용은 UpdatePanel 컨트롤 개요 하 고 부분 페이지 렌더링 개요합니다.

적용 대상

추가 정보