ComboBox.FindString Méthode

Définition

Retourne l'index du premier élément dans le ComboBox qui démarre avec la chaîne spécifiée.Returns the index of the first item in the ComboBox that starts with the specified string.

Surcharges

FindString(String)

Retourne l'index du premier élément dans le ComboBox qui démarre avec la chaîne spécifiée.Returns the index of the first item in the ComboBox that starts with the specified string.

FindString(String, Int32)

Retourne l'index du premier élément dans le ComboBox au delà de l'index spécifié qui contient la chaîne spécifiée.Returns the index of the first item in the ComboBox beyond the specified index that contains the specified string. La recherche ne respecte pas la casse.The search is not case sensitive.

FindString(String)

Retourne l'index du premier élément dans le ComboBox qui démarre avec la chaîne spécifiée.Returns the index of the first item in the ComboBox that starts with the specified string.

public:
 int FindString(System::String ^ s);
public int FindString (string s);
member this.FindString : string -> int
Public Function FindString (s As String) As Integer

Paramètres

s
String

String à rechercher.The String to search for.

Retours

Index de base zéro du premier élément trouvé ; retourne -1 si aucune correspondance n'est trouvée.The zero-based index of the first item found; returns -1 if no match is found.

Exemples

L’exemple de code suivant illustre l’utilisation de la méthode FindString et SelectedIndex propriété.The following code example shows the usage of the FindString method and SelectedIndex property. L’exemple fait partie d’un exemple de code complet dans la vue d’ensemble de la classe ComboBox.The example is part of a complete code example in the ComboBox class overview.

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

Remarques

La recherche effectuée par cette méthode ne respecte pas la casse.The search performed by this method is not case-sensitive. Le paramètre s est une sous-chaîne à comparer par rapport au texte associé aux éléments de la liste de zone de liste déroulante.The s parameter is a substring to compare against the text associated with the items in the combo box list. La recherche effectue une correspondance partielle à partir du début du texte, et retourne le premier élément de la liste qui correspond à la sous-chaîne spécifiée.The search performs a partial match starting from the beginning of the text, and returning the first item in the list that matches the specified substring. Vous pouvez ensuite effectuer des tâches, telles que la suppression de l’élément qui contient le texte recherché à l’aide de la méthode Remove ou la modification du texte de l’élément.You can then perform tasks, such as removing the item that contains the search text using the Remove method or changing the item's text. Une fois que vous avez trouvé le texte spécifié, si vous souhaitez rechercher d’autres instances du texte dans la ComboBox, vous devez utiliser la version de la méthode FindString qui fournit un paramètre pour spécifier un index de départ dans le ComboBox.Once you have found the specified text, if you want to search for other instances of the text in the ComboBox, you must use the version of the FindString method that provides a parameter for specifying a starting index within the ComboBox. Si vous souhaitez effectuer une recherche pour une correspondance exacte de mot au lieu d’une correspondance partielle, utilisez la méthode FindStringExact.If you want to perform a search for an exact word match instead of a partial match, use the FindStringExact method.

FindString(String, Int32)

Retourne l'index du premier élément dans le ComboBox au delà de l'index spécifié qui contient la chaîne spécifiée.Returns the index of the first item in the ComboBox beyond the specified index that contains the specified string. La recherche ne respecte pas la casse.The search is not case sensitive.

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

Paramètres

s
String

String à rechercher.The String to search for.

startIndex
Int32

Index de base zéro de l'élément précédant le premier élément sur lequel la recherche est effectuée.The zero-based index of the item before the first item to be searched. Assignez la valeur -1 pour rechercher à partir du début du contrôle.Set to -1 to search from the beginning of the control.

Retours

Index de base zéro du premier élément trouvé ; retourne -1 si aucune correspondance n'est trouvée ou 0 si le paramètre s spécifie Empty.The zero-based index of the first item found; returns -1 if no match is found, or 0 if the s parameter specifies Empty.

Exceptions

startIndex est inférieur à -1.The startIndex is less than -1.

- ou --or- startIndex est supérieur au dernier index dans la collection.The startIndex is greater than the last index in the collection.

Remarques

La recherche effectuée par cette méthode ne respecte pas la casse.The search performed by this method is not case-sensitive. Le paramètre s est une sous-chaîne à comparer par rapport au texte associé aux éléments de la liste de zone de liste déroulante.The s parameter is a substring to compare against the text associated with the items in the combo box list. La recherche effectue une correspondance partielle à partir du début du texte, en retournant le premier élément de la liste qui correspond à la sous-chaîne spécifiée.The search performs a partial match starting from the beginning of the text, returning the first item in the list that matches the specified substring. Vous pouvez ensuite effectuer des tâches, telles que la suppression de l’élément qui contient le texte recherché à l’aide de la méthode Remove ou la modification du texte de l’élément.You can then perform tasks, such as removing the item that contains the search text using the Remove method or changing the item's text. Cette méthode est généralement utilisée après qu’un appel a été effectué à l’aide de la version de cette méthode qui ne spécifie pas d’index de départ.This method is typically used after a call has been made using the version of this method that does not specify a starting index. Une fois qu’un élément initial a été trouvé dans la liste, cette méthode est généralement utilisée pour rechercher d’autres instances du texte recherché en spécifiant la position d’index dans le paramètre startIndex de l’élément après la première instance trouvée du texte recherché.Once an initial item has been found in the list, this method is typically used to find further instances of the search text by specifying the index position in the startIndex parameter of the item after the first found instance of the search text. Si vous souhaitez effectuer une recherche pour une correspondance exacte de mot au lieu d’une correspondance partielle, utilisez la méthode FindStringExact.If you want to perform a search for an exact word match instead of a partial match, use the FindStringExact method.

S’applique à