HtmlSelect.SelectedIndex 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
HtmlSelect 컨트롤에서 선택된 항목의 서수 인덱스를 가져오거나 설정합니다.
public:
virtual property int SelectedIndex { int get(); void set(int value); };[System.ComponentModel.Browsable(false)]
public virtual int SelectedIndex { get; set; }[<System.ComponentModel.Browsable(false)>]
member this.SelectedIndex : int with get, setPublic Overridable Property SelectedIndex As Integer속성 값
HtmlSelect 컨트롤에서 선택된 항목의 서수 인덱스입니다. -1 값은 선택된 항목이 없음을 나타냅니다.
- 특성
예외
속성이 HtmlSelect 컨트롤에 있는 항목 수보다 큰 값이나 -1보다 작은 값으로 설정된 경우
예제
다음 코드 예제에서는 컨트롤에서 SelectedIndex HtmlSelect 선택한 항목의 인덱스를 확인 하려면 속성을 사용 하는 방법을 보여 줍니다. 그런 다음 인덱스는 컬렉션에서 선택한 항목을 검색하는 Items 데 사용됩니다.
<%@ 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> HtmlSelect Example </title>
<script runat="server">
void Button_Click (Object sender, EventArgs e)
{
Label1.Text = "You selected the item with index number " +
Select1.SelectedIndex.ToString() +
" and contains the value " +
Select1.Value + ".";
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3> HtmlSelect Example </h3>
Select items from the list: <br /><br />
<select id="Select1"
runat="server">
<option value="Text for Item 1" selected="selected"> Item 1 </option>
<option value="Text for Item 2"> Item 2 </option>
<option value="Text for Item 3"> Item 3 </option>
<option value="Text for Item 4"> Item 4 </option>
<option value="Text for Item 5"> Item 5 </option>
<option value="Text for Item 6"> Item 6 </option>
</select>
<br /><br />
<button id="Button1"
onserverclick="Button_Click"
runat="server">
Submit
</button>
<br /><br />
<asp:Label id="Label1"
runat="server"/>
</form>
</body>
</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>
<title> HtmlSelect Example </title>
<script runat="server">
Sub Button_Click (sender As Object, e As EventArgs)
Label1.Text = "You selected the item with index number " & _
Select1.SelectedIndex.ToString() & _
" and contains the value " & _
Select1.Value & "."
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3> HtmlSelect Example </h3>
Select items from the list: <br /><br />
<select id="Select1"
runat="server">
<option value="Text for Item 1" selected="selected"> Item 1 </option>
<option value="Text for Item 2"> Item 2 </option>
<option value="Text for Item 3"> Item 3 </option>
<option value="Text for Item 4"> Item 4 </option>
<option value="Text for Item 5"> Item 5 </option>
<option value="Text for Item 6"> Item 6 </option>
</select>
<br /><br />
<button id="Button1"
onserverclick="Button_Click"
runat="server">
Submit
</button>
<br /><br />
<asp:Label id="Label1"
runat="server"/>
</form>
</body>
</html>
설명
이 SelectedIndex 속성은 일반적으로 단일 선택 HtmlSelect 컨트롤에서 선택한 항목의 인덱스 확인에 사용됩니다. 그런 다음 이 인덱스로 컬렉션에서 항목을 검색할 Items 수 있습니다.
Multiple 여러 항목을 동시에 선택할 SelectedIndex 수 있음을 나타내는 속성이 설정된 true경우 속성에 첫 번째 선택한 항목의 인덱스가 포함됩니다. 여러 개의 동시 선택을 허용하는 컨트롤에서 HtmlSelect 선택한 항목을 확인하려면 컬렉션을 반복 Items 하고 각 항목의 속성을 테스트 ListItem.Selected 합니다.
주의
선택한 항목이 없을 수 있습니다. 항목을 선택하지 않으면 속성에 SelectedIndex 값 -1이 포함됩니다. 이는 일반적으로 페이지가 처음 로드되고 항목이 기본적으로 선택되지 않을 때 발생합니다. 컬렉션의 Items 항목을 참조하기 전에 이 값을 테스트하는 코드를 제공합니다. 그렇지 않으면 인덱스가 컬렉션 범위를 벗어나면 예외가 throw됩니다.
기본적으로 HtmlSelect 컨트롤은 드롭다운 목록 상자로 표시됩니다. 속성을 true여러 개 선택 Multiple 하도록 허용하거나 한 행보다 큰 높이를 지정하면(속성을 보다 1큰 값으로 설정Size) 컨트롤이 목록 상자로 표시됩니다. 드롭다운 목록 상자가 표시되면 항목이 항상 선택됩니다. 목록 상자가 표시되면 속성을 -1.로 설정 SelectedIndex 하여 모든 항목에서 선택 영역을 프로그래밍 방식으로 지울 수 있습니다.