ComboBox.FindString Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Vrátí index první položky v objektu ComboBox , který začíná zadaným řetězcem.

Přetížení

FindString(String)	Vrátí index první položky v objektu ComboBox , který začíná zadaným řetězcem.
FindString(String, Int32)	Vrátí index první položky nad ComboBox rámec zadaného indexu, který obsahuje zadaný řetězec. Při hledání se nerozlišuje velká a malá písmena.

FindString(String)

Vrátí index první položky v objektu ComboBox , který začíná zadaným řetězcem.

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

Hledaný String .

Návraty

Int32

Nulový index první nalezené položky; vrátí hodnotu -1, pokud není nalezena žádná shoda.

Příklady

Následující příklad kódu ukazuje použití FindString metody a SelectedIndex vlastnosti. Příklad je součástí úplného příkladu kódu v přehledu ComboBox třídy.

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

Poznámky

Při hledání prováděném touto metodou se nerozlišují malá a malá písmena. Parametr s je podřetěc pro porovnání s textem přidruženým k položkám v seznamu polí se seznamem. Hledání provede částečnou shodu od začátku textu a vrátí první položku v seznamu, která odpovídá zadanému podřetěžci. Pak můžete provádět úlohy, jako je odebrání položky obsahující hledaný text pomocí Remove metody nebo změna textu položky. Jakmile najdete zadaný text a chcete vyhledat další instance textu v objektu ComboBox, musíte použít verzi FindString metody, která poskytuje parametr pro zadání počátečního indexu ComboBoxv souboru . Pokud chcete místo částečné shody hledat přesnou shodu slov, použijte metodu FindStringExact .

FindString(String, Int32)

Vrátí index první položky nad ComboBox rámec zadaného indexu, který obsahuje zadaný řetězec. Při hledání se nerozlišuje velká a malá písmena.

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

Hledaný String .

startIndex

Int32

Index položky založený na nule před první položkou, která má být prohledána. Pokud chcete hledat od začátku ovládacího prvku, nastavte na hodnotu -1.

Návraty

Int32

Nulový index první nalezené položky; vrátí hodnotu -1, pokud není nalezena žádná shoda, nebo hodnotu 0, pokud s parametr určuje Emptyhodnotu .

Výjimky

ArgumentOutOfRangeException

Hodnota startIndex je menší než -1.

-nebo-

Hodnota startIndex je větší než poslední index v kolekci.

Poznámky

Při hledání prováděném touto metodou se nerozlišují malá a malá písmena. Parametr s je podřetěc pro porovnání s textem přidruženým k položkám v seznamu polí se seznamem. Hledání provede částečnou shodu počínaje začátkem textu a vrátí první položku v seznamu, která odpovídá zadanému podřetěžci. Pak můžete provádět úlohy, jako je odebrání položky obsahující hledaný text pomocí Remove metody nebo změna textu položky. Tato metoda se obvykle používá po volání pomocí verze této metody, která neurčí počáteční index. Jakmile byla v seznamu nalezena počáteční položka, tato metoda se obvykle používá k vyhledání dalších instancí hledaného textu zadáním pozice indexu v parametru startIndex položky za první nalezenou instancí hledaného textu. Pokud chcete místo částečné shody hledat přesnou shodu slov, použijte metodu FindStringExact .