ComboBox.FindString Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Devuelve el índice del primer elemento de ComboBox que comienza con la cadena especificada.

Sobrecargas

FindString(String)	Devuelve el índice del primer elemento de ComboBox que comienza con la cadena especificada.
FindString(String, Int32)	Devuelve el índice del primer elemento de ComboBox después del índice especificado que contiene la cadena especificada. La búsqueda no hace distinción de mayúsculas y minúsculas.

FindString(String)

Devuelve el índice del primer elemento de ComboBox que comienza con la cadena 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

String que se va a buscar.

Devoluciones

Int32

Índice de base cero del primer elemento encontrado; devuelve -1 si no hay coincidencias.

Ejemplos

En el ejemplo de código siguiente se muestra el uso del método y SelectedIndex la FindString propiedad . El ejemplo forma parte de un ejemplo de código completo en la información general de la ComboBox clase.

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

Comentarios

La búsqueda realizada por este método no distingue mayúsculas de minúsculas. El s parámetro es una subcadena que se va a comparar con el texto asociado a los elementos de la lista de cuadros combinados. La búsqueda realiza una coincidencia parcial a partir del principio del texto y devuelve el primer elemento de la lista que coincide con la subcadena especificada. A continuación, puede realizar tareas, como quitar el elemento que contiene el texto de búsqueda mediante el Remove método o cambiar el texto del elemento. Una vez que haya encontrado el texto especificado, si desea buscar otras instancias del texto en ComboBox, debe usar la versión del FindString método que proporciona un parámetro para especificar un índice inicial dentro de ComboBox. Si desea realizar una búsqueda de una coincidencia exacta de palabras en lugar de una coincidencia parcial, use el FindStringExact método .

FindString(String, Int32)

Devuelve el índice del primer elemento de ComboBox después del índice especificado que contiene la cadena especificada. La búsqueda no hace distinción de mayúsculas y 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

String que se va a buscar.

startIndex

Int32

Índice de base cero del elemento situado delante del primer elemento que se va a buscar. Se establece en -1 para buscar desde el principio del control.

Devoluciones

Int32

Índice de base cero del primer elemento encontrado; devuelve -1 si no hay coincidencias o 0 si el parámetro s indica Empty.

Excepciones

ArgumentOutOfRangeException

startIndex es menor que -1.

o bien

startIndex es mayor que el último índice de la colección.

Comentarios

La búsqueda realizada por este método no distingue mayúsculas de minúsculas. El s parámetro es una subcadena que se va a comparar con el texto asociado a los elementos de la lista de cuadros combinados. La búsqueda realiza una coincidencia parcial a partir del principio del texto y devuelve el primer elemento de la lista que coincide con la subcadena especificada. A continuación, puede realizar tareas, como quitar el elemento que contiene el texto de búsqueda mediante el Remove método o cambiar el texto del elemento. Este método se usa normalmente después de realizar una llamada mediante la versión de este método que no especifica un índice inicial. Una vez que se ha encontrado un elemento inicial en la lista, este método se usa normalmente para buscar más instancias del texto de búsqueda especificando la posición de índice en el startIndex parámetro del elemento después de la primera instancia encontrada del texto de búsqueda. Si desea realizar una búsqueda de una coincidencia exacta de palabras en lugar de una coincidencia parcial, use el FindStringExact método .