HtmlSelect.SelectedIndex 属性
08/17/2007
本文内容
获取或设置 HtmlSelect 控件中的选定项的序号索引。
**命名空间:**System.Web.UI.HtmlControls
**程序集:**System.Web(在 system.web.dll 中)
语法
声明
Public Overridable Property SelectedIndex As Integer
用法
Dim instance As HtmlSelect
Dim value As Integer
value = instance.SelectedIndex
instance.SelectedIndex = value
public virtual int SelectedIndex { get; set; }
public:
virtual property int SelectedIndex {
int get ();
void set (int value);
}
/** @property */
public int get_SelectedIndex ()
/** @property */
public void set_SelectedIndex (int value)
public function get SelectedIndex () : int
public function set SelectedIndex (value : int)
属性值
HtmlSelect 控件中的选定项的序号索引。值 -1 指示未选择任何项。
备注
SelectedIndex 属性通常用于确定单一选择的 HtmlSelect 控件中选定项的索引。然后,该索引即可用于检索 Items 集合中的项。
如果 Multiple 属性设置为 true(指示可以同时选择多个项),则 SelectedIndex 属性包含第一个选择项的索引。若要确定允许同时的多重选择的 HtmlSelect 控件中的选定项,请循环访问 Items 集合并测试各项的 ListItem.Selected 属性。
警告
可以不选定任何项。如果未选定任何项,SelectedIndex 属性将包含值 -1。这通常在页面第一次加载并且在默认情况下没有选定任何项时发生。提供代码以在引用 Items 集合中的项之前测试此值。否则,如果索引超出了该集合的范围,将引发异常。
默认情况下,HtmlSelect 控件显示为下拉列表框。如果允许多重选择(通过将 Multiple 属性设置为 true)或指定的高度大于一行(通过将 Size 属性设置为大于 1 的值),控件将显示为列表框。如果显示下拉列表框,则始终会选择一个项。如果显示列表框,则可以通过将 SelectedIndex 属性设置为 -1 以编程方式清除对所有项的选择。
示例
下面的代码示例演示如何使用 SelectedIndex 属性确定 HtmlSelect 控件中的选择项的索引。然后使用该索引从 Items 集合中检索选定项。
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
HtmlSelect Example
Select items from the list:
Multiple="False"
runat="server">
Item 1
Item 2
Item 3
Item 4
Item 5
Item 6
OnServerClick="Button_Click"
runat="server">
Submit
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 + ".";
}
HtmlSelect Example
Select items from the list:
Multiple="False"
runat="server">
Item 1
Item 2
Item 3
Item 4
Item 5
Item 6
OnServerClick="Button_Click"
runat="server">
Submit
runat="server"/>
function Button_Click (sender : Object, e: EventArgs) : void
{
Label1.Text = "You selected the item with index number " +
Select1.SelectedIndex.ToString() +
" and contains the value " +
Select1.Value + ".";
}
HtmlSelect Example
Select items from the list:
Multiple="False"
runat="server">
Item 1
Item 2
Item 3
Item 4
Item 5
Item 6
OnServerClick="Button_Click"
runat="server">
Submit
runat="server"/>
平台
Windows 98、Windows 2000 SP4、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition
.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表,请参见系统要求。
版本信息
.NET Framework
受以下版本支持:2.0、1.1、1.0
请参见
参考
其他资源