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, set
Public 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如果该属性设置为 true
,则指示可以同时选择多个项,则SelectedIndex属性包含第一个选定项的索引。 若要从 HtmlSelect 允许多个同时选择的控件中确定所选项,请循环访问 Items 集合并测试 ListItem.Selected 每个项的属性。
注意
可能未选择任何项。 如果未选择任何项,则 SelectedIndex 属性包含值 -1
。 当页面首次加载且默认情况下未选择项时,通常会发生这种情况。 提供代码以在引用集合中的 Items 项之前测试此值。 否则,如果索引超过集合范围,则会引发异常。
默认情况下,控件 HtmlSelect 显示为下拉列表框。 如果通过将属性设置为 Multiple true
) 或通过将属性设置为 Size 大于 1
) 的值来指定大于一 (行的高度,则控件将显示为列表框 (。 如果显示下拉列表框,始终选择一个项目。 If a list box is displayed, you can programmatically clear the selection from all items by setting the SelectedIndex property to -1
.