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 indeksie ComboBox poza określonym indeksem zawierającym 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 zerach pierwszego znalezionego elementu; 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 jest uwzględniane 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 zmiany tekstu elementu. Po znalezieniu określonego tekstu, jeśli chcesz wyszukać inne wystąpienia tekstu w pliku ComboBox, należy użyć wersji FindString metody, która udostępnia parametr do określenia indeksu początkowego w obiekcie ComboBox. Jeśli chcesz wyszukać dokładne dopasowanie wyrazu zamiast częściowego dopasowania, użyj FindStringExact metody .

FindString(String, Int32)

Zwraca indeks pierwszego elementu w indeksie ComboBox poza określonym indeksem zawierającym 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 zera elementu przed przeszukanym pierwszym elementem. Ustaw wartość -1, aby wyszukać od początku kontrolki.

Zwraca

Int32

Indeks oparty na zerach pierwszego znalezionego elementu; 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 jest uwzględniane 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 pasujący 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 zmiany 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 dalszych 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 .