Button 웹 서버 컨트롤 선언 구문

업데이트: 2007년 11월

Web Forms 페이지에 누름 단추를 표시하는 컨트롤입니다.

<asp:Button
    AccessKey="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CausesValidation="True|False"
    CommandArgument="string"
    CommandName="string"
    CssClass="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    OnClick="Click event handler"
    OnClientClick="string"
    OnCommand="Command event handler"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    PostBackUrl="uri"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Text="string"
    ToolTip="string"
    UseSubmitBehavior="True|False"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
/>

설명

Button 컨트롤을 사용하여 Web Forms 페이지에 누름 단추를 만들 수 있습니다. 이 컨트롤을 사용하면 submit 단추 또는 command 단추라는 두 가지 종류의 단추를 만들 수 있습니다.

기본적으로 Button 컨트롤은 submit 단추를 렌더링합니다. submit 단추에는 CommandName 속성에 지정된 명령 이름이 연결되어 있지 않으며 이 단추를 클릭하면 단순히 웹 페이지가 서버에 다시 게시됩니다. submit 단추를 클릭하는 경우 수행되는 작업을 프로그래밍 방식으로 제어하기 위해 Click 이벤트에 대한 이벤트 처리기를 제공할 수 있습니다.

command 단추에는 CommandName 속성을 설정하여 지정된 명령 이름(예: Sort)이 연결되어 있습니다. 따라서 Web Forms 페이지에 여러 개의 Button 컨트롤을 만들고, Command 이벤트에 대한 이벤트 처리기를 통해 어떤 Button 컨트롤을 클릭했는지 프로그래밍 방식으로 확인할 수 있습니다. command 단추에 CommandArgument 속성을 사용하면 수행할 명령에 대한 추가 정보(예: Ascending)를 제공할 수도 있습니다. command 단추를 클릭하는 경우 수행되는 작업을 프로그래밍 방식으로 제어하기 위해 Command 이벤트에 대한 이벤트 처리기를 제공할 수 있습니다.

Command 단추는 DataList에서 선택하거나 FormView에서 모드를 변경하는 경우처럼 템플릿 기반 컨트롤에서 부모 컨트롤에 작업을 알리는 데 주로 사용됩니다.

기본적으로 Button 컨트롤을 클릭하면 페이지 유효성 검사가 수행됩니다. 페이지 유효성 검사에서는 페이지에 있는 유효성 검사 컨트롤과 연결된 입력 컨트롤이 유효성 검사 컨트롤에서 지정한 유효성 검사 규칙을 통과하는지 여부를 확인합니다. reset 단추와 같이 이 동작을 비활성화해야 하는 Button 컨트롤에 대해서는 CausesValidation 속성을 false로 설정합니다.

Button 컨트롤에 표시되는 캡션을 지정하려면 Text 속성을 설정합니다.

Button 컨트롤의 속성과 이벤트에 대한 자세한 내용은 Button 설명서를 참조하십시오.

예제

다음 예제에서는 .aspx 파일에서 submit 단추 컨트롤을 선언하는 방법을 보여 줍니다.

<asp:Button id="SubmitButton"
     Text="Submit"
     CommandName="Submit"
     OnCommand="CommandBtn_Click"
     runat="server"  />

<asp:Button id="SubmitButton"
     Text="Submit"
     CommandName="Submit"
     OnCommand="CommandBtn_Click"
     runat="server"/>

다음 예제에서는 .aspx 파일에서 command 단추 컨트롤을 선언하는 방법을 보여 줍니다.

<asp:Button id="SortAscendingButton"
     Text="Sort Ascending"
     CommandName="Sort"
     CommandArgument="Ascending"
     OnCommand="CommandBtn_Click"
     runat="server"/>

<asp:Button id="SortAscendingButton"
     Text="Sort Ascending"
     CommandName="Sort"
     CommandArgument="Ascending"
     OnCommand="CommandBtn_Click"
     runat="server"/>

다음 예제에서는 단추 클릭을 확인하고, CommandName 및 CommandArgument 속성을 통해 단추에서 전달되는 정보를 표시하는 이벤트 처리 메서드를 보여 줍니다.

Sub CommandBtn_Click(ByVal sender As Object, ByVal e As CommandEventArgs)
    Message.Text = "You clicked the " & e.CommandName & _
                   " - " & e.CommandArgument & " button."
End Sub

void CommandBtn_Click(Object sender, CommandEventArgs e)
{
    Message.Text = "You clicked the " + e.CommandName +
                   " - " + e.CommandArgument + " button.";
}

참고 항목

참조

Button

기타 리소스

웹 서버 컨트롤 구문