ComboBox.FindString Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Retourne l’index du premier élément du ComboBox premier élément qui commence par la chaîne spécifiée.

Surcharges

Nom	Description
FindString(String)	Retourne l’index du premier élément du ComboBox premier élément qui commence par la chaîne spécifiée.
FindString(String, Int32)	Retourne l’index du premier élément au-delà ComboBox de l’index spécifié qui contient la chaîne spécifiée. La recherche n’est pas sensible à la casse.

FindString(String)

Source:

ComboBox.cs

Retourne l’index du premier élément du ComboBox premier élément qui commence par 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 n’est pas sensible à la casse. Le s paramètre est une sous-chaîne à comparer au texte associé aux éléments de la liste déroulante. 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. 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 Remove méthode ou la 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 le ComboBox, vous devez utiliser la version de la FindString méthode qui fournit un paramètre pour spécifier un index de départ dans le ComboBox. Si vous souhaitez effectuer une recherche d’une correspondance exacte au lieu d’une correspondance partielle, utilisez la FindStringExact méthode.

FindString(String, Int32)

Source:

ComboBox.cs

Retourne l’index du premier élément au-delà ComboBox de l’index spécifié qui contient la chaîne spécifiée. La recherche n’est pas sensible à 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 avant le premier élément à rechercher. Définissez la valeur -1 pour effectuer une recherche à 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 s paramètre spécifie Empty.

Exceptions

ArgumentOutOfRangeException

La startIndex valeur est inférieure à -1.

- ou -

La startIndex valeur est supérieure au dernier index de la collection.

Remarques

La recherche effectuée par cette méthode n’est pas sensible à la casse. Le s paramètre est une sous-chaîne à comparer au texte associé aux éléments de la liste déroulante. 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. 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 Remove méthode ou la 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 trouvée du texte de recherche. Si vous souhaitez effectuer une recherche d’une correspondance exacte au lieu d’une correspondance partielle, utilisez la FindStringExact méthode.