ListBox 웹 서버 컨트롤 개요

아티클
10/22/2014

업데이트: 2007년 11월

ListBox 웹 서버 컨트롤을 사용하면 미리 정의된 목록에서 하나 이상의 항목을 선택하도록 할 수 있습니다.

이 항목의 내용은 다음과 같습니다.

시나리오
기능
배경
코드 예제
클래스 참조

시나리오

여러 개의 항목을 즉시 표시하고 사용자가 미리 정의된 목록에서 하나 이상의 항목을 선택할 수 있도록 하려면 ListBox 웹 서버 컨트롤을 사용합니다. ListBox 컨트롤은 여러 항목을 즉시 표시할 수 있고 사용자가 필요에 따라 여러 항목을 선택할 수 있는 DropDownList 컨트롤과 다릅니다.

맨 위로 이동

기능

ListBox 컨트롤을 사용하여 다음과 같은 작업을 수행할 수 있습니다.

컨트롤을 설정하여 지정된 항목 수 표시
컨트롤 크기를 픽셀 단위로 설정
데이터 바인딩을 사용하여 표시할 항목 목록 지정
선택된 항목 확인
선택된 항목을 프로그래밍 방식으로 지정

맨 위로 이동

배경

ListBox 컨트롤은 일반적으로 한 번에 두 개 이상의 항목을 표시할 때 사용합니다. 목록의 모양을 제어하는 방법은 다음과 같습니다.

표시되는 행 수. 특정 항목 수를 표시하도록 컨트롤을 설정할 수 있습니다. 컨트롤에 이보다 많은 항목이 있는 경우 세로 스크롤 막대가 표시됩니다.
높이 및 너비. 픽셀을 사용하여 컨트롤의 크기를 설정할 수 있습니다. 이 경우 컨트롤은 설정된 행의 개수를 무시하고 컨트롤 높이에 맞는 행의 개수를 표시합니다. 일부 브라우저에서는 높이와 너비를 픽셀 단위로 설정할 수 없으므로 행 개수 설정을 사용합니다.

다른 웹 서버 컨트롤과 마찬가지로 스타일 개체를 사용하여 컨트롤의 모양을 지정할 수 있습니다. 자세한 내용은 ASP.NET 웹 서버 컨트롤 및 CSS 스타일을 참조하십시오.

목록 항목

ListBox 컨트롤은 하나 이상의 목록 항목에 대한 컨테이너입니다. 각 목록 항목은 자체 속성을 가지고 있는 ListItem 형식의 개체입니다. 이러한 속성은 다음과 같습니다.

속성	설명
Text	목록에 표시되는 텍스트를 지정합니다.
Value	항목과 연결된 값이 포함되어 있습니다. 이 속성을 설정하면 값을 표시하지 않고도 특정 항목과 연결할 수 있습니다. 예를 들어 Text 속성을 색 이름으로 설정하고 Value 속성을 16진수 표현으로 설정할 수 있습니다.
Selected	항목의 현재 선택 여부를 나타냅니다.

프로그래밍 방식으로 항목을 사용하려면 ListBox 컨트롤의 Items 컬렉션을 사용합니다. Items 컬렉션은 표준 컬렉션이며 이 컬렉션에 항목 개체를 추가 및 삭제할 수 있을 뿐 아니라 컬렉션 자체를 지울 수도 있습니다.

현재 선택된 항목은 ListBox 컨트롤의 SelectedItem 속성에서 사용할 수 있습니다. 컨트롤이 단일 선택 모드로 설정된 경우 이 속성은 하나의 선택된 항목을 반환합니다. 컨트롤이 다중 선택 모드로 설정된 경우에는 Items 컬렉션 전체를 반복하고 각 항목의 Selected 속성을 검사하여 선택된 항목을 가져옵니다.

단일 선택과 다중 선택

일반적으로 단일 항목을 목록에서 클릭하여 선택할 수 있습니다. ListBox 컨트롤이 다중 선택을 허용하도록 설정하면 Ctrl 또는 Shift 키를 누른 상태로 여러 항목을 클릭하여 선택할 수 있습니다.

컨트롤에 데이터 바인딩

ListBox 웹 서버 컨트롤을 사용하면 데이터 소스 컨트롤을 통해 페이지에서 사용할 수 있는 옵션을 나열할 수 있습니다. ListBox 컨트롤의 각 항목은 데이터 소스의 한 항목(일반적으로 개별 데이터 레코드)에 해당합니다.

컨트롤은 소스의 한 필드를 표시합니다. 필요에 따라 컨트롤을 두 번째 필드에 바인딩하여 표시되지 않는 항목의 값을 설정할 수 있습니다.

다른 서버 컨트롤과 마찬가지로 컨트롤의 색 또는 크기와 같은 모든 컨트롤 속성을 데이터에 바인딩할 수 있습니다. 자세한 내용은 방법: 데이터 소스에서 List 웹 서버 컨트롤 채우기(Visual Studio)를 참조하십시오.

ListBox 이벤트

ListBox 컨트롤은 사용자가 항목을 선택할 때 SelectedIndexChanged 이벤트를 발생시킵니다. 기본적으로 이 이벤트로 인해 페이지가 서버로 게시되지는 않지만 AutoPostBack 속성을 true로 설정하면 컨트롤이 강제로 즉시 포스트백될 수 있습니다.

참고:
자동 포스트백 기능을 사용하려면 브라우저에서 ECMAScript(Jscript 또는 JavaScript)를 지원하고 사용자 브라우저에 이 스크립트가 활성화되어 있어야 합니다.