ComboBox.SelectedIndex Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

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

[System.ComponentModel.Browsable(false)]
public override int SelectedIndex { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.SelectedIndex : int with get, set

Public Overrides Property SelectedIndex As Integer

Eigenschaftswert

Int32

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

Attribute: BrowsableAttribute

Ausnahmen

ArgumentOutOfRangeException

Der angegebene Index ist kleiner oder gleich -2.

- oder -

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

Beispiele

Im folgenden Codebeispiel wird die Verwendung der -Methode und SelectedIndex -FindStringEigenschaft veranschaulicht. Das Beispiel ist Teil eines vollständigen Beispiels in der ComboBox Klassenübersicht.

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.Text);
    comboBox1.SelectedIndex = index;
}

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

Hinweise

Diese Eigenschaft gibt den nullbasierten Index des derzeit ausgewählten Elements in der Kombinationsfeldliste an. Das Festlegen eines neuen Index löst das SelectedIndexChanged -Ereignis aus.

SelectedIndex, SelectedValueund FormattingEnabled sind wie folgt verknüpft:

Wenn FormattingEnabled ist false, SelectedIndex wird nicht auf -1 festgelegt, wenn SelectedValue leer ist.
Wenn FormattingEnabled ist true, SelectedIndex wird auf -1 festgelegt, wenn SelectedValue leer ist.

Hinweis

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

Gilt für: