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

请参见

参考

其他资源