ComboBox.FindString Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Retourne l'index du premier élément dans le ComboBox qui démarre avec la chaîne spécifiée.

Surcharges

FindString(String)	Retourne l'index du premier élément dans le ComboBox qui démarre avec la chaîne spécifiée.
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. La recherche ne respecte pas la casse.

FindString(String)

Retourne l'index du premier élément dans le ComboBox qui démarre avec la chaîne spécifiée.

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.

Retours

Int32

Index de base zéro du premier élément trouvé ; retourne -1 si aucune correspondance n'est trouvée.

Exemples

L’exemple de code suivant montre l’utilisation de la méthode et SelectedIndex de la FindString propriété. L’exemple fait partie d’un exemple de code complet dans la vue d’ensemble de la 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

Remarques

La recherche effectuée par cette méthode ne respecte pas la casse. Le s paramètre est une sous-chaîne à comparer au texte associé aux éléments de la liste de zone de liste déroulante. La recherche effectue une correspondance partielle à partir du début du texte et retourne le premier élément de la liste correspondant à la sous-chaîne spécifiée. Vous pouvez ensuite effectuer des tâches, telles que la suppression de l’élément qui contient le texte de recherche à l’aide de la méthode ou la Remove modification du texte de l’élément. Une fois que vous avez trouvé le texte spécifié, si vous souhaitez rechercher d’autres instances du texte dans , ComboBoxvous devez utiliser la version de la FindString méthode qui fournit un paramètre pour spécifier un index de départ dans .ComboBox Si vous souhaitez effectuer une recherche pour une correspondance de mot exacte au lieu d’une correspondance partielle, utilisez la FindStringExact méthode .

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. La recherche ne respecte pas la casse.

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.

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. Assignez la valeur -1 pour rechercher à partir du début du contrôle.

Retours

Int32

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.

Exceptions

ArgumentOutOfRangeException

startIndex est inférieur à -1.

- ou -

startIndex est supérieur au dernier index dans la collection.

Remarques

La recherche effectuée par cette méthode ne respecte pas la casse. Le s paramètre est une sous-chaîne à comparer au texte associé aux éléments de la liste de zone de liste déroulante. La recherche effectue une correspondance partielle à partir du début du texte, renvoyant le premier élément de la liste qui correspond à la sous-chaîne spécifiée. Vous pouvez ensuite effectuer des tâches, telles que la suppression de l’élément qui contient le texte de recherche à l’aide de la méthode ou la Remove modification du texte de l’élément. 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. 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 de recherche en spécifiant la position d’index dans le startIndex paramètre de l’élément après la première instance du texte de recherche. Si vous souhaitez effectuer une recherche pour une correspondance de mot exacte au lieu d’une correspondance partielle, utilisez la FindStringExact méthode .