ComboBox.FindString Método

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

Parâmetros

Retornos

O índice baseado em zero do primeiro item encontrado; retornará -1 se nenhuma correspondência for encontrada.

Exemplos

O exemplo de código a seguir mostra o uso do método e SelectedIndex da FindString propriedade . O exemplo faz parte de um exemplo de código completo na visão geral da ComboBox classe.

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

Comentários

A pesquisa executada por esse método não diferencia maiúsculas de minúsculas. O s parâmetro é uma subcadeia de caracteres a ser comparada com o texto associado aos itens na lista de caixas de combinação. A pesquisa executa uma correspondência parcial começando do início do texto e retornando o primeiro item na lista que corresponde à subcadeia de caracteres especificada. Em seguida, você pode executar tarefas, como remover o item que contém o texto de pesquisa usando o Remove método ou alterar o texto do item. Depois de encontrar o texto especificado, se você quiser pesquisar outras instâncias do texto no ComboBox, deverá usar a versão do FindString método que fornece um parâmetro para especificar um índice inicial dentro do ComboBox. Se você quiser executar uma pesquisa para uma correspondência exata de palavras em vez de uma correspondência parcial, use o FindStringExact método .

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

Parâmetros

Retornos

O índice baseado em zero do primeiro item encontrado; retorna -1 se nenhuma correspondência é encontrada, ou 0 se o parâmetro s especifica Empty.

Exceções

Comentários

A pesquisa executada por esse método não diferencia maiúsculas de minúsculas. O s parâmetro é uma subcadeia de caracteres a ser comparada com o texto associado aos itens na lista de caixas de combinação. A pesquisa executa uma correspondência parcial a partir do início do texto, retornando o primeiro item na lista que corresponde à subcadeia de caracteres especificada. Em seguida, você pode executar tarefas, como remover o item que contém o texto de pesquisa usando o Remove método ou alterar o texto do item. Esse método normalmente é usado depois que uma chamada é feita usando a versão desse método que não especifica um índice inicial. Depois que um item inicial é encontrado na lista, esse método normalmente é usado para localizar mais instâncias do texto de pesquisa especificando a posição do índice no startIndex parâmetro do item após a primeira instância encontrada do texto de pesquisa. Se você quiser executar uma pesquisa para uma correspondência exata de palavras em vez de uma correspondência parcial, use o FindStringExact método .