ComboBox.FindString Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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

Überlädt

FindString(String)

Gibt den Index des ersten Elements im ComboBox zurück, das mit der angegebenen Zeichenfolge beginnt.
FindString(String, Int32)

Gibt den Index des ersten Elements in der ComboBox außerhalb des angegebenen Indexes zurück, der die angegebene Zeichenfolge enthält. Bei der Suche wird die Groß- und Kleinschreibung nicht berücksichtigt.

FindString(String)

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

public:
 int FindString(System::String ^ s);
public int FindString (string s);
public int FindString (string? s);
member this.FindString : string -> int
Public Function FindString (s As String) As Integer

Parameter

s
String

Die zu suchende String.

Gibt zurück

Int32

Der nullbasierte Index des ersten gefundenen Elements. Wenn keine Übereinstimmung gefunden wurde, wird -1 zurückgegeben.

Beispiele

Das folgende Codebeispiel zeigt die Verwendung der -Methode und SelectedIndex -FindStringEigenschaft. 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 partielle Übereinstimmung ab dem Anfang des Texts durch 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 Element, das den Suchtext enthält, mithilfe der Remove -Methode entfernen oder den Text des Elements ändern. Nachdem Sie den angegebenen Text gefunden haben, müssen Sie die Version FindString der -Methode verwenden, die einen Parameter zum Angeben eines Startindexes innerhalb ComboBoxdes ComboBoxbereitstellt, wenn Sie nach anderen Instanzen des Texts suchen möchten. Wenn Sie eine Suche nach einer exakten Wortüberstimmung anstelle einer partiellen Übereinstimmung durchführen möchten, verwenden Sie die FindStringExact -Methode.

Gilt für:

FindString(String, Int32)

Gibt den Index des ersten Elements in der ComboBox außerhalb des angegebenen Indexes zurück, der die angegebene Zeichenfolge enthält. Bei der Suche wird die Groß- und Kleinschreibung nicht berücksichtigt.

public:
 int FindString(System::String ^ s, int startIndex);
public int FindString (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

Die zu suchende String.

startIndex
Int32

Der nullbasierte Index des Elements vor dem ersten zu durchsuchenden Element. Legen Sie -1 fest, um ab dem Anfang im Steuerelement zu suchen.

Gibt zurück

Int32

Der nullbasierte Index des ersten gefundenen Elements. Wenn keine Übereinstimmung gefunden wurde, wird -1 zurückgegeben. Wenn der s-Parameter Empty angibt, wird 0 (null) zurückgegeben.

Ausnahmen

ArgumentOutOfRangeException

Der startIndex ist kleiner als -1.

- oder -

Der startIndex 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 partielle Übereinstimmung ab dem Anfang des Texts durch 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 Element, das den Suchtext enthält, mithilfe der Remove -Methode entfernen oder den Text des Elements ändern. 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 dem ersten gefundenen instance des Suchtexts angegeben wird. Wenn Sie eine Suche nach einer exakten Wortüberstimmung anstelle einer partiellen Übereinstimmung durchführen möchten, verwenden Sie die FindStringExact -Methode.

Gilt für: