ComboBox.SelectedIndex 属性

获取或设置指定当前选定项的索引。

**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms（在 system.windows.forms.dll 中）

语法

声明
Public Overrides Property SelectedIndex As Integer
用法
Dim instance As ComboBox
Dim value As Integer

value = instance.SelectedIndex

instance.SelectedIndex = value

public override int SelectedIndex { get; set; }

public:
virtual property int SelectedIndex {
    int get () override;
    void set (int value) override;
}

/** @property */
public int get_SelectedIndex ()

/** @property */
public void set_SelectedIndex (int value)

public override function get SelectedIndex () : int

public override function set SelectedIndex (value : int)

属性值

当前选定项的从零开始的索引。如果未选定任何项，则返回值为负一 (-1)。

异常

异常类型	条件
ArgumentOutOfRangeException	指定的索引小于或等于 -2。 - 或 - 指定的索引大于或等于组合框中的项数。

备注

该属性指示组合框列表中当前选定项从零开始的索引。设置新的索引将引发 SelectedIndexChanged 事件。

SelectedIndex、SelectedValue 及 FormattingEnabled 的关系如下：

• 如果 FormattingEnabled 为 false，则当 SelectedValue 为空时，SelectedIndex 不会被设置为 -1。

• 如果 FormattingEnabled 为 true，则当 SelectedValue 为空时，SelectedIndex 将被设置为 -1。

提示

若要取消选择当前选定项，请将 SelectedIndex 设置为 -1。如果 ComboBox 项是数据绑定项，则不能将该项的 SelectedIndex 设置为 -1。

示例

下面的代码示例演示如何使用 FindString 方法和 SelectedIndex 属性。此示例摘自 ComboBox 类概述中的一个完整示例。

Private Sub findButton_Click(ByVal sender As Object, ByVal e As System.EventArgs)
    Dim index As Integer
    index = comboBox1.FindString(textBox2.Text)
    comboBox1.SelectedIndex = index
End Sub

private void findButton_Click(object sender, System.EventArgs e) {
    int index = comboBox1.FindString(textBox2.Text);
    comboBox1.SelectedIndex = index;
}

void findButton_Click( Object^ sender, System::EventArgs^ e )
{
   int index = comboBox1->FindString( textBox2->Text );
   comboBox1->SelectedIndex = index;
}

private void findButton_Click(Object sender, System.EventArgs e)
{
    int index = comboBox1.FindString(textBox2.get_Text());
    comboBox1.set_SelectedIndex(index);
} //findButton_Click

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、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

.NET Compact Framework

受以下版本支持：2.0、1.0

请参见

参考

ComboBox 类
ComboBox 成员
System.Windows.Forms 命名空间
Position
FormattingEnabled
SelectedValue