ComboBox.FindString Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Retorna o índice do primeiro item em ComboBox que começa com a cadeia de caracteres especificada.

Sobrecargas

FindString(String)	Retorna o índice do primeiro item em ComboBox que começa com a cadeia de caracteres especificada.
FindString(String, Int32)	Retorna o índice do primeiro item no ComboBox além do índice especificado que contém a cadeia de caracteres especificada. A pesquisa não diferencia maiúsculas de minúsculas.

FindString(String)

Retorna o índice do primeiro item em ComboBox que começa com a cadeia de caracteres especificada.

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

public int FindString (string? s);

member this.FindString : string -> int

Public Function FindString (s As String) As Integer

Parâmetros

s

String

O String a ser pesquisado.

Retornos

Int32

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 .

FindString(String, Int32)

Retorna o índice do primeiro item no ComboBox além do índice especificado que contém a cadeia de caracteres especificada. A pesquisa não diferencia maiúsculas de minúsculas.

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

Parâmetros

s

String

O String a ser pesquisado.

startIndex

Int32

O índice baseado em zero do item antes do primeiro item a ser pesquisado. Defina como -1 para pesquisar desde o início do controle.

Retornos

Int32

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

ArgumentOutOfRangeException

O startIndex é menor que -1.

- ou -

O startIndex é maior que o último índice na coleção.

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 .