다음을 통해 공유


CheckBox 웹 서버 컨트롤 선언 구문

업데이트: 2007년 11월

사용자가 true 상태와 false 상태 간을 전환하는 데 사용할 수 있는 확인란 컨트롤을 만듭니다.

<asp:CheckBox
    AccessKey="string"
    AutoPostBack="True|False"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CausesValidation="True|False"
    Checked="True|False"
    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"
    OnCheckedChanged="CheckedChanged 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"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Text="string"
    TextAlign="Left|Right"
    ToolTip="string"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
/>

설명

CheckBox 컨트롤은 사용자가 true 상태와 false 상태 간을 전환하는 데 사용할 수 있는 확인란을 Web Forms 페이지에 만듭니다. Text 속성을 설정하면 컨트롤에 표시할 캡션을 지정할 수 있습니다. 캡션을 확인란의 왼쪽 또는 오른쪽에 표시할 수 있으며, TextAlign 속성을 설정하여 캡션이 표시되는 위치를 지정할 수 있습니다.

참고

<asp:CheckBox> 요소에는 내용이 없으므로 별도의 닫는 태그 대신 />를 사용하여 태그를 닫을 수 있습니다.

CheckBox 컨트롤을 선택했는지 여부를 확인하려면 Checked 속성을 테스트합니다. 서버에 게시할 때마다 CheckBox 컨트롤의 상태가 변경되는 경우 CheckedChanged 이벤트가 발생합니다. 서버에 게시할 때마다 CheckBox 컨트롤의 상태가 변경되는 경우 특정 작업을 수행하도록 CheckedChanged 이벤트에 대한 이벤트 처리기를 제공할 수 있습니다.

참고

CheckBox 컨트롤을 여러 개 만드는 경우 CheckBoxList 컨트롤을 사용할 수도 있습니다. CheckBoxList 컨트롤을 사용하면 데이터 바인딩을 사용하여 좀 더 쉽게 확인란 집합을 만들 수 있고 개별 CheckBox 컨트롤을 사용하면 레이아웃을 세밀하게 제어할 수 있다는 이점이 있습니다.

기본적으로 CheckBox 컨트롤을 클릭하면 폼이 서버에 자동으로 게시되지 않습니다. 폼을 서버에 자동으로 게시하려면 AutoPostBack 속성을 true로 설정합니다.

경고

텍스트는 CheckBox 컨트롤에 표시된 후에 HTML로 인코딩됩니다. 따라서 텍스트의 HTML 태그 내에 스크립트를 포함시킬 수 있습니다. 컨트롤 값을 사용자 입력에서 가져온 경우 값이 유효한지 확인하여 보안상의 허점을 방지합니다.

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

예제

다음 예제에서는 .aspx 파일에서 CheckBox 컨트롤을 선언하는 샘플을 보여 줍니다. 이 선언에서는 확인란을 선택하면 폼을 즉시 서버에 다시 게시하도록 설정되어 있습니다.

<asp:CheckBox id="Check1" runat="server"
     Text="CheckBox 1"
     AutoPostBack="True"/>
<asp:CheckBox id="Check1" runat="server"
     Text="CheckBox 1"
     AutoPostBack="True"/>

다음 예제에서는 고객의 대금 청구 주소가 포함된 텍스트 상자의 내용을 배송 주소가 포함된 텍스트 상자에 복사하기 위해 CheckedChanged 이벤트에 대한 이벤트 처리기를 만드는 방법을 보여 줍니다.

보안 정보:

이 예제에는 사용자 입력을 허용하는 텍스트 상자가 있으므로 보안상 위험할 수 있습니다. 기본적으로 ASP.NET 페이지에서는 사용자 입력 내용에 스크립트나 HTML 요소가 포함되어 있지 않은지 유효성을 검사합니다. 자세한 내용은 스크립트 악용 개요를 참조하십시오.

<%@ Page Language="VB" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>CheckBox Web Server Control Declarative Syntax</title>

   <script runat="server">

      Sub Check_Clicked(sender As Object, e As EventArgs) 

         If SameCheckBox.Checked Then
            ShipTextBox.Text = BillTextBox.Text
         Else
            ShipTextBox.Text = ""
         End If

      End Sub

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3>CheckBox Example</h3>








      <table>
         <tr>
            <td>
               Billing Address: <br />
               <asp:TextBox id="BillTextBox"
                    TextMode="MultiLine"
                    Rows="5" 
                    runat="server"/>
            </td>
            <td>
               Shipping Address: <br />
               <asp:TextBox id="ShipTextBox"
                    TextMode="MultiLine"
                    Rows="5" 
                    runat="server"/>
            </td>
         </tr>
         <tr>
            <td>
            </td>
            <td>
               <asp:CheckBox id="SameCheckBox"
                    AutoPostBack="True"
                    Text="Same as billing."
                    TextAlign="Right"
                    OnCheckedChanged="Check_Clicked"
                    runat="server"/>
            </td>
         </tr>
      </table>


   </form>

</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>CheckBox Example</title>
<script runat="server">

      void Check_Clicked(Object sender, EventArgs e) 
      {
         if(SameCheckBox.Checked)
            ShipTextBox.Text = BillTextBox.Text;
         else
            ShipTextBox.Text = "";
      }

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3>CheckBox Example</h3>








      <table>
         <tr>
            <td>
               Billing Address: <br />
               <asp:TextBox id="BillTextBox"
                    TextMode="MultiLine"
                    Rows="5" 
                    runat="server"/>
            </td>
            <td>
               Shipping Address: <br />
               <asp:TextBox id="ShipTextBox"
                    TextMode="MultiLine"
                    Rows="5" 
                    runat="server"/>
            </td>
         </tr>
         <tr>
            <td>
            </td>
            <td>
               <asp:CheckBox id="SameCheckBox"
                    AutoPostBack="True"
                    Text="Same as billing."
                    TextAlign="Right"
                    OnCheckedChanged="Check_Clicked"
                    runat="server"/>
            </td>
         </tr>
      </table>


   </form>

</body>
</html> 

참고 항목

참조

CheckBox

기타 리소스

웹 서버 컨트롤 구문