ComboBox.FindString Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Zwraca indeks pierwszego elementu w elemencie ComboBox rozpoczynającym się od określonego ciągu.

Przeciążenia

FindString(String)	Zwraca indeks pierwszego elementu w elemencie ComboBox rozpoczynającym się od określonego ciągu.
FindString(String, Int32)	Zwraca indeks pierwszego elementu w ComboBox poza określonym indeksem, który zawiera określony ciąg. Wyszukiwanie nie uwzględnia wielkości liter.

FindString(String)

Zwraca indeks pierwszego elementu w elemencie ComboBox rozpoczynającym się od określonego ciągu.

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

public int FindString (string? s);

member this.FindString : string -> int

Public Function FindString (s As String) As Integer

Parametry

s

String

Element do wyszukania String .

Zwraca

Int32

Indeks oparty na zerze pierwszego znalezionego elementu; metoda zwraca wartość -1, jeśli nie znaleziono dopasowania.

Przykłady

Poniższy przykład kodu przedstawia użycie FindString metody i SelectedIndex właściwości. Przykład jest częścią kompletnego przykładu kodu w przeglądzie ComboBox klasy.

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

Uwagi

Wyszukiwanie wykonywane przez tę metodę nie uwzględnia wielkości liter. Parametr s jest podciągem do porównania z tekstem skojarzonym z elementami na liście pól kombi. Wyszukiwanie wykonuje częściowe dopasowanie rozpoczynające się od początku tekstu i zwraca pierwszy element na liście, który pasuje do określonego podciągu. Następnie można wykonywać zadania, takie jak usuwanie elementu zawierającego tekst wyszukiwania przy użyciu Remove metody lub zmienianie tekstu elementu. Po znalezieniu określonego tekstu, jeśli chcesz wyszukać inne wystąpienia tekstu w ComboBoxpliku , należy użyć wersji FindString metody , która udostępnia parametr służący do określania indeksu początkowego ComboBoxw obiekcie . Jeśli chcesz wyszukać dokładne dopasowanie wyrazu zamiast częściowego dopasowania, użyj FindStringExact metody .

FindString(String, Int32)

Zwraca indeks pierwszego elementu w ComboBox poza określonym indeksem, który zawiera określony ciąg. Wyszukiwanie nie uwzględnia wielkości liter.

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

Parametry

s

String

Element do wyszukania String .

startIndex

Int32

Indeks na podstawie zera elementu przed pierwszym elementem do przeszukania. Ustaw wartość -1, aby wyszukać od początku kontrolki.

Zwraca

Int32

Indeks oparty na zerze pierwszego znalezionego elementu; metoda zwraca wartość -1, jeśli nie znaleziono dopasowania, lub 0, jeśli s parametr określa Emptywartość .

Wyjątki

ArgumentOutOfRangeException

Wartość startIndex jest mniejsza niż -1.

-lub-

Wartość startIndex jest większa niż ostatni indeks w kolekcji.

Uwagi

Wyszukiwanie wykonywane przez tę metodę nie uwzględnia wielkości liter. Parametr s jest podciągem do porównania z tekstem skojarzonym z elementami na liście pól kombi. Wyszukiwanie wykonuje częściowe dopasowanie rozpoczynające się od początku tekstu, zwracając pierwszy element na liście zgodny z określonym podciągem. Następnie można wykonywać zadania, takie jak usuwanie elementu zawierającego tekst wyszukiwania przy użyciu Remove metody lub zmienianie tekstu elementu. Ta metoda jest zwykle używana po wywołaniu przy użyciu wersji tej metody, która nie określa indeksu początkowego. Po znalezieniu początkowego elementu na liście ta metoda jest zwykle używana do znajdowania kolejnych wystąpień tekstu wyszukiwania przez określenie pozycji indeksu w startIndex parametrze elementu po pierwszym znalezionym wystąpieniu tekstu wyszukiwania. Jeśli chcesz wyszukać dokładne dopasowanie wyrazu zamiast częściowego dopasowania, użyj FindStringExact metody .