ListBox 웹 서버 컨트롤 선언 구문
업데이트: 2007년 11월
한 번에 하나의 항목만 선택할 수 있는 목록 상자나 한 번에 여러 항목을 선택할 수 있는 목록 상자를 만드는 데 사용하는 컨트롤입니다.
<asp:ListBox
AccessKey="string"
AppendDataBoundItems="True|False"
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"
CssClass="string"
DataMember="string"
DataSource="string"
DataSourceID="string"
DataTextField="string"
DataTextFormatString="string"
DataValueField="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"
OnDataBinding="DataBinding event handler"
OnDataBound="DataBound event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnSelectedIndexChanged="SelectedIndexChanged event handler"
OnTextChanged="TextChanged event handler"
OnUnload="Unload event handler"
Rows="integer"
runat="server"
SelectedIndex="integer"
SelectedValue="string"
SelectionMode="Single|Multiple"
SkinID="string"
Style="string"
TabIndex="integer"
ToolTip="string"
ValidationGroup="string"
Visible="True|False"
Width="size"
>
<asp:ListItem
Enabled="True|False"
Selected="True|False"
Text="string"
Value="string"
/>
</asp:ListBox>
설명
ListBox 컨트롤을 사용하면 한 번에 하나의 항목만 선택할 수 있는 목록 상자나 한 번에 여러 항목을 선택할 수 있는 목록 상자를 만들 수 있습니다. Rows 속성을 사용하여 컨트롤의 높이를 지정합니다. 여러 항목을 선택할 수 있도록 하려면 SelectionMode 속성을 Multiple로 설정합니다.
ListBox 컨트롤에 표시할 항목을 지정하려면 각 항목에 대한 ListItem 요소를 ListBox 컨트롤의 여는 태그와 닫는 태그 사이에 추가합니다.
ListBox 컨트롤에서는 데이터 바인딩도 지원합니다. 컨트롤을 데이터 소스에 바인딩하려면 먼저 컨트롤에 표시할 항목이 포함된 데이터 소스(예: DataSourceControl 개체)를 만듭니다. 그런 다음 DataBind 메서드를 사용하여 데이터 소스를 ListBox 컨트롤에 바인딩합니다. DataTextField 및 DataValueField 속성을 사용하면 컨트롤에 있는 각 목록 항목의 Text 속성과 Value 속성에 각각 바인딩할 데이터 소스 필드를 지정할 수 있습니다. 그러면 ListBox 컨트롤에서는 데이터 소스에서 가져온 정보를 표시합니다.
SelectionMode 속성을 Multiple로 설정한 경우에는 Items 컬렉션을 반복하면서 컬렉션에 포함된 각 항목의 Selected 속성을 테스트하여 ListBox 컨트롤에서 선택된 항목을 확인합니다. SelectionMode 속성을 Single로 설정한 경우에는 SelectedIndex 속성을 사용하여 선택된 항목의 인덱스를 확인할 수 있습니다. 그런 다음 이 인덱스를 사용하여 Items 컬렉션에서 항목을 검색할 수 있습니다.
ListBox 웹 서버 컨트롤의 속성과 이벤트에 대한 자세한 내용은 ListBox 클래스 설명서를 참조하십시오.
예제
다음 예제에서는 ListBox 컨트롤을 사용하여 미리 정의된 옵션 목록을 사용자에게 표시하는 방법을 보여 줍니다. 사용자가 선택한 항목은 Label 컨트롤에 표시됩니다.
<%@ 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>
<title>ListBox Example</title>
<script language="VB" runat="server">
Sub SubmitBtn_Click(sender As Object, e As EventArgs)
If ListBox1.SelectedIndex > - 1 Then
Label1.Text = "You chose: " & ListBox1.SelectedItem.Text
End If
End Sub 'SubmitBtn_Click
</script>
</head>
<body>
<h3>ListBox Example</h3>
<form id="form1" runat="server">
<asp:ListBox id="ListBox1"
Rows="6"
Width="100px"
SelectionMode="Single"
runat="server">
<asp:ListItem>Item 1</asp:ListItem>
<asp:ListItem>Item 2</asp:ListItem>
<asp:ListItem>Item 3</asp:ListItem>
<asp:ListItem>Item 4</asp:ListItem>
<asp:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</asp:ListBox>
<asp:button id="Button1"
Text="Submit"
OnClick="SubmitBtn_Click"
runat="server" />
<asp:Label id="Label1"
Font-Names="Verdana"
Font-Size="10pt"
runat="server"/>
</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>
<title>ListBox Example</title>
<script language="C#" runat="server">
void SubmitBtn_Click(Object sender, EventArgs e)
{
if (ListBox1.SelectedIndex > -1)
Label1.Text="You chose: " + ListBox1.SelectedItem.Text;
}
</script>
</head>
<body>
<h3>ListBox Example</h3>
<form id="form1" runat="server">
<asp:ListBox id="ListBox1"
Rows="6"
Width="100px"
SelectionMode="Single"
runat="server">
<asp:ListItem>Item 1</asp:ListItem>
<asp:ListItem>Item 2</asp:ListItem>
<asp:ListItem>Item 3</asp:ListItem>
<asp:ListItem>Item 4</asp:ListItem>
<asp:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</asp:ListBox>
<asp:button id="Button1"
Text="Submit"
OnClick="SubmitBtn_Click"
runat="server" />
<asp:Label id="Label1"
Font-Names="Verdana"
Font-Size="10pt"
runat="server"/>
</form>
</body>
</html>