ComboBox.SelectedIndex-Eigenschaft

Artikel
08/20/2007

Ruft den Index des derzeit ausgewählten Elements ab oder legt diesen fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Overrides Property SelectedIndex As Integer
'Usage
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)

Eigenschaftenwert

Ein nullbasierter Index des derzeit ausgewählten Elements. Wenn kein Element ausgewählt ist, wird ein Wert von -1 zurückgegeben.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentOutOfRangeException	Der angegebene Index ist kleiner oder gleich -2. - oder - Der angegebene Index ist größer oder gleich der Anzahl von Elementen im Kombinationsfeld.

ArgumentOutOfRangeException

Der angegebene Index ist kleiner oder gleich -2.

- oder -

Der angegebene Index ist größer oder gleich der Anzahl von Elementen im Kombinationsfeld.

Hinweise

Diese Eigenschaft gibt den nullbasierten Index des derzeit in der Kombinationsfeldliste ausgewählten Elements an. Durch Festlegen eines neuen Indexes wird das SelectedIndexChanged-Ereignis ausgelöst.

SelectedIndex, SelectedValue und FormattingEnabled sind wie folgt verknüpft:

Wenn FormattingEnabledfalse ist, wird SelectedIndex nicht auf -1 festgelegt, wenn SelectedValue leer ist.
Wenn FormattingEnabledtrue ist, wird SelectedIndex auf -1 festgelegt, wenn SelectedValue leer ist.

Hinweis

Um die Auswahl des derzeit ausgewählten Elements aufzuheben, legen Sie den SelectedIndex auf -1 fest. Sie können den SelectedIndex eines ComboBox-Elements nicht auf -1 festlegen, wenn es sich bei dem Element um ein datengebundenes Element handelt.

Beispiel

Im folgenden Codebeispiel wird die Verwendung der FindString-Methode und der SelectedIndex-Eigenschaft veranschaulicht. Dieses Codebeispiel ist Teil eines umfassenden Beispiels in der Übersicht zur ComboBox-Klasse.

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

ComboBox-Klasse
ComboBox-Member
System.Windows.Forms-Namespace
Position
FormattingEnabled
SelectedValue

Freigeben über