ComboBox.FindString Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Gibt den Index des ersten Elements zurück, das ComboBox mit der angegebenen Zeichenfolge beginnt.

Überlädt

Name	Beschreibung
FindString(String)	Gibt den Index des ersten Elements zurück, das ComboBox mit der angegebenen Zeichenfolge beginnt.
FindString(String, Int32)	Gibt den Index des ersten Elements im ComboBox jenseits des angegebenen Indexes zurück, der die angegebene Zeichenfolge enthält. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet.

FindString(String)

Quelle:

ComboBox.cs

Gibt den Index des ersten Elements zurück, das ComboBox mit der angegebenen Zeichenfolge beginnt.

public:
 int FindString(System::String ^ s);

public int FindString(string? s);

member this.FindString : string -> int

Public Function FindString (s As String) As Integer

Parameter

s

String

Der String gesuchte Suchbegriff.

Gibt zurück

Int32

Der nullbasierte Index des ersten gefundenen Elements; gibt -1 zurück, wenn keine Übereinstimmung gefunden wird.

Beispiele

Das folgende Codebeispiel zeigt die Verwendung der FindString Methode und SelectedIndex Eigenschaft. Das Beispiel ist Teil eines vollständigen Codebeispiels 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

Bei der von dieser Methode durchgeführten Suche wird die Groß-/Kleinschreibung nicht beachtet. Der s Parameter ist eine Teilzeichenfolge, die mit dem Text verglichen werden soll, der den Elementen in der Kombinationsfeldliste zugeordnet ist. Die Suche führt eine teilweise Übereinstimmung ab dem Anfang des Texts aus und gibt das erste Element in der Liste zurück, das der angegebenen Teilzeichenfolge entspricht. Anschließend können Sie Aufgaben ausführen, z. B. das Entfernen des Elements, das den Suchtext enthält, mithilfe der Remove Methode oder Ändern des Texts des Elements. Nachdem Sie den angegebenen Text gefunden haben, müssen Sie, wenn Sie nach anderen Instanzen des Texts im ComboBoxText suchen möchten, die Version der Methode verwenden, die FindString einen Parameter zum Angeben eines Startindex in der ComboBox. Wenn Sie eine Suche nach einer exakten Wortabgleichung anstelle einer teilweisen Übereinstimmung durchführen möchten, verwenden Sie die FindStringExact Methode.

FindString(String, Int32)

Quelle:

ComboBox.cs

Gibt den Index des ersten Elements im ComboBox jenseits des angegebenen Indexes zurück, der die angegebene Zeichenfolge enthält. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet.

public:
 int FindString(System::String ^ s, int startIndex);

public int FindString(string? s, int startIndex);

member this.FindString : string * int -> int

Public Function FindString (s As String, startIndex As Integer) As Integer

Parameter

s

String

Der String gesuchte Suchbegriff.

startIndex

Int32

Der nullbasierte Index des Elements, bevor das erste Element durchsucht werden soll. Legen Sie diese Einstellung auf -1 fest, um vom Anfang des Steuerelements aus zu suchen.

Gibt zurück

Int32

Der nullbasierte Index des ersten gefundenen Elements; gibt -1 zurück, wenn keine Übereinstimmung gefunden wird, oder 0, wenn der s Parameter angibt Empty.

Ausnahmen

ArgumentOutOfRangeException

Dies startIndex ist kleiner als -1.

- oder -

Der startIndex Wert ist größer als der letzte Index in der Auflistung.

Hinweise

Bei der von dieser Methode durchgeführten Suche wird die Groß-/Kleinschreibung nicht beachtet. Der s Parameter ist eine Teilzeichenfolge, die mit dem Text verglichen werden soll, der den Elementen in der Kombinationsfeldliste zugeordnet ist. Die Suche führt eine teilweise Übereinstimmung ab dem Anfang des Texts durch, wobei das erste Element in der Liste zurückgegeben wird, das mit der angegebenen Teilzeichenfolge übereinstimmt. Anschließend können Sie Aufgaben ausführen, z. B. das Entfernen des Elements, das den Suchtext enthält, mithilfe der Remove Methode oder Ändern des Texts des Elements. Diese Methode wird in der Regel verwendet, nachdem ein Aufruf mit der Version dieser Methode erfolgt ist, die keinen Startindex angibt. Sobald ein anfängliches Element in der Liste gefunden wurde, wird diese Methode in der Regel verwendet, um weitere Instanzen des Suchtexts zu finden, indem die Indexposition im startIndex Parameter des Elements nach der ersten gefundenen Instanz des Suchtexts angegeben wird. Wenn Sie eine Suche nach einer exakten Wortabgleichung anstelle einer teilweisen Übereinstimmung durchführen möchten, verwenden Sie die FindStringExact Methode.