CheckBox 및 CheckBoxList 웹 서버 컨트롤 개요
업데이트: 2007년 11월
CheckBox 컨트롤 및 CheckBoxList 컨트롤은 사용자가 예/아니요(true/false) 선택을 지정할 수 있는 방법을 제공합니다.
이 항목의 내용은 다음과 같습니다.
기능
배경
코드 예제
클래스 참조
기능
CheckBox 컨트롤 및 CheckBoxList 컨트롤을 사용하여 다음을 수행할 수 있습니다.
확인란을 선택할 때 페이지 포스트백을 일으킵니다.
사용자가 확인란을 선택할 때의 사용자 상호 작용을 캡처합니다.
각 확인란을 데이터베이스의 데이터에 바인딩합니다.
맨 위로 이동
배경
두 유형의 웹 서버 컨트롤, 즉 개별 CheckBox 컨트롤 또는 CheckBoxList 컨트롤을 사용하여 ASP.NET 웹 페이지에 확인란을 추가할 수 있습니다. 두 컨트롤 모두 사용자가 yes/no(true/false) 선택을 지정할 수 있는 방법을 제공합니다.
개별 CheckBox 컨트롤의 경우 페이지에 추가한 다음 단독으로 사용합니다. 또는 확인란 목록 항목의 컬렉션에 대해 부모 컨트롤 역할을 수행하는 단일 컨트롤인 CheckBoxList 컨트롤을 사용할 수 있습니다. 이 컨트롤은 기본 ListControl 클래스에서 파생되므로 ListBox, DropDownList, RadioButtonList 및 BulletedList 웹 서버 컨트롤과 매우 유사하게 작동합니다. CheckBoxList 컨트롤을 사용하는 대부분의 프로시저는 다른 List 서버 컨트롤을 사용하는 프로시저와 같습니다.
두 컨트롤 형식 모두 장점이 있습니다. 개별 CheckBox 컨트롤을 사용하면 CheckBoxList 컨트롤을 사용하는 것보다 페이지의 확인란 레이아웃을 더욱 정밀하게 제어할 수 있습니다. 예를 들어 각 확인란 사이에 확인란용이 아닌 텍스트를 넣을 수 있습니다. 또한 각 확인란의 글꼴과 색을 확인란별로 제어할 수 있습니다.
데이터 소스의 데이터를 사용하여 일련의 확인란을 만들려면 CheckBoxList 컨트롤을 사용하는 것이 좋습니다. 개별 CheckBox 컨트롤을 데이터에 바인딩할 수 있습니다.
.gif "참고") 참고: |
|---|
HtmlInputCheckBox 컨트롤을 사용하여 ASP.NET 웹 페이지에 확인란을 추가할 수도 있습니다. 자세한 내용은 HtmlInputCheckBox 서버 컨트롤 선언 구문을 참조하십시오. |
CheckBox 및 CheckBoxList 이벤트
개별 CheckBox 컨트롤과 CheckBoxList 컨트롤에 대한 이벤트는 다소 다르게 동작합니다.
CheckBox 컨트롤 이벤트
개별 CheckBox 컨트롤을 클릭하면 CheckedChanged 이벤트가 발생합니다. 기본적으로 이 이벤트로 인해 페이지가 서버로 게시되지는 않습니다. 그러나 AutoPostBack 속성을 true로 설정하여 컨트롤이 즉시 포스트백을 수행하도록 강제 적용할 수 있습니다. 자세한 내용은 방법: CheckBox 웹 서버 컨트롤의 사용자 선택에 응답을 참조하십시오.
| 참고: |
|---|
자동 포스트백 기능을 사용하려면 브라우저에서 ECMAScript(Jscript 또는 JavaScript)를 지원하고 사용자 브라우저에 이 스크립트가 활성화되어 있어야 합니다. |
CheckedChanged 이벤트에 대한 이벤트 처리기를 만들 필요가 없을 수도 있습니다. 페이지의 일부분으로 실행되는 코드에서 선택된 확인란을 테스트할 수 있습니다. 일반적으로 확인란의 값을 읽는 것만이 아니라 확인란이 변경되었음을 알고 있어야 하는 경우에만 CheckedChanged 이벤트에 대한 이벤트 처리기를 만듭니다. 자세한 내용은 방법: RadioButton 웹 서버 컨트롤의 선택 설정 및 가져오기를 참조하십시오.
CheckBoxList 컨트롤 이벤트
CheckBoxList 컨트롤은 목록에 있는 확인란 중 하나가 선택되면 SelectedIndexChanged 이벤트를 발생시킵니다. 기본적으로 이 이벤트로 인해 페이지가 서버로 게시되지는 않습니다. 그러나 AutoPostBack 속성을 true로 설정하여 컨트롤이 즉시 포스트백을 수행하도록 강제 적용할 수 있습니다.
| 참고: |
|---|
자동 포스트백 기능을 사용하려면 브라우저에서 ECMAScript(Jscript 또는 JavaScript)를 지원하고 사용자 브라우저에 이 스크립트가 활성화되어 있어야 합니다. |
개별 CheckBox 컨트롤의 경우와 같이 일반적으로 페이지가 다른 방법으로 게시된 다음 CheckBoxList 컨트롤의 상태를 테스트합니다. 자세한 내용은 방법: List 웹 서버 컨트롤의 선택 확인을 참조하십시오.
CheckBox 컨트롤 HTML 특성
CheckBox 컨트롤은 두 부분, 즉 확인란을 나타내는 input 요소와 확인란의 캡션을 나타내는 개별 label 요소를 브라우저에 렌더링합니다. 그런 다음 이 두 요소의 조합이 span 요소에 래핑됩니다.
스타일 또는 특성 설정을 CheckBox 컨트롤에 적용하면 설정이 외부 SPAN 요소에 적용됩니다. 예를 들어 컨트롤의 BackColor 속성을 설정하면 설정이 span 요소에 적용됩니다. 따라서 내부 input 및 label 특성 모두에 영향을 줍니다.
때로는 확인란과 레이블을 개별적으로 설정할 수도 있습니다. CheckBox 컨트롤은 런타임에 설정할 수 있는 두 속성을 지원합니다. InputAttributes 속성은 HTML 특성을 input 요소에 추가할 수 있도록 하고, LabelAttributes 속성은 HTML 특성을 label 요소에 추가할 수 있도록 합니다. 설정하는 특성은 원래 상태로 브라우저에 전달됩니다. 다음 예제에서는 마우스 포인터를 대면 레이블이 아닌 확인란의 색만 변하도록 input 요소의 특성을 설정하는 방법을 보여 줍니다.
[Visual Basic]
CheckBox1.InputAttributes.Add("onmouseover", _
"this.style.backgroundColor = 'red'")
CheckBox1.InputAttributes.Add("onmouseout", _
"this.style.backgroundColor = 'white'")
CheckBox1.InputAttributes.Add("onmouseover",
"this.style.backgroundColor = 'red'");
CheckBox1.InputAttributes.Add("onmouseout",
"this.style.backgroundColor = 'white'");
컨트롤에 데이터 바인딩
개별 CheckBox 컨트롤을 데이터 소스에 바인딩하고, CheckBox 컨트롤의 모든 속성을 데이터 소스의 모든 필드에 바인딩할 수 있습니다. 예를 들어 일반적으로 데이터베이스의 정보를 기반으로 컨트롤의 Checked 속성을 설정합니다.
CheckBoxList 컨트롤도 데이터 소스에 바인딩할 수 있습니다. 이 경우 각 확인란은 데이터 소스의 개별 레코드를 표시합니다.
맨 위로 이동
코드 예제
방법: Web Forms 페이지에 CheckBox 웹 서버 컨트롤 추가(Visual Studio)
방법: Web Forms 페이지에 CheckBoxList 웹 서버 컨트롤 추가(Visual Studio)
방법: CheckBoxList 웹 서버 컨트롤의 레이아웃 설정
방법: 프로그래밍 방식으로 CheckBox 웹 서버 컨트롤 값 가져오기 및 설정
방법: CheckBox 웹 서버 컨트롤의 사용자 선택에 응답
방법: List 웹 서버 컨트롤에 항목 추가(Visual Studio)
방법: 데이터 소스에서 List 웹 서버 컨트롤 채우기(Visual Studio)
맨 위로 이동
클래스 참조
다음 표에서는 CheckBox 및 CheckBoxList 컨트롤과 관련된 클래스를 보여 줍니다.
멤버 |
설명 |
|---|---|
CheckBox 컨트롤의 기본 클래스입니다. |
|
CheckBoxList 컨트롤의 기본 클래스입니다. |
|
CheckBoxList 컨트롤의 각 항목을 나타내는 클래스입니다. |
|
CheckBoxList 컨트롤에 대해 목록의 개별 항목에 해당하는 항목 컬렉션입니다. |
맨 위로 이동
참고 항목
작업
방법: List 웹 서버 컨트롤의 선택 설정(Visual Studio)