ComboBox.FindString Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Restituisce l'indice del primo elemento nell'oggetto ComboBox che inizia con la stringa specificata.

Overload

FindString(String)	Restituisce l'indice del primo elemento nell'oggetto ComboBox che inizia con la stringa specificata.
FindString(String, Int32)	Restituisce l'indice del primo elemento in ComboBox successivo all'indice specificato che contiene la stringa specificata. Alla ricerca non viene applicata la distinzione tra maiuscole e minuscole.

FindString(String)

Restituisce l'indice del primo elemento nell'oggetto ComboBox che inizia con la stringa specificata.

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

public int FindString (string? s);

member this.FindString : string -> int

Public Function FindString (s As String) As Integer

Parametri

s

String

Oggetto String da cercare.

Restituisce

Int32

Indice in base zero del primo elemento trovato; restituisce -1 se non vengono trovate corrispondenze.

Esempio

Nell'esempio di codice seguente viene illustrato l'utilizzo del metodo e SelectedIndex della FindString proprietà . L'esempio fa parte di un esempio di codice completo nella panoramica della 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

Commenti

La ricerca eseguita da questo metodo non fa distinzione tra maiuscole e minuscole. Il s parametro è una sottostringa da confrontare con il testo associato agli elementi nell'elenco casella combinata. La ricerca esegue una corrispondenza parziale a partire dall'inizio del testo e restituendo il primo elemento dell'elenco corrispondente alla sottostringa specificata. È quindi possibile eseguire attività, ad esempio rimuovere l'elemento contenente il testo di ricerca usando il Remove metodo o modificare il testo dell'elemento. Dopo aver trovato il testo specificato, se si desidera cercare altre istanze del testo in ComboBox, è necessario usare la versione del metodo che fornisce un parametro per specificare un indice iniziale all'interno di FindStringComboBox. Se si desidera eseguire una ricerca di una corrispondenza esatta di parola anziché una corrispondenza parziale, usare il FindStringExact metodo .

FindString(String, Int32)

Restituisce l'indice del primo elemento in ComboBox successivo all'indice specificato che contiene la stringa specificata. Alla ricerca non viene applicata la distinzione tra maiuscole e minuscole.

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

Parametri

s

String

Oggetto String da cercare.

startIndex

Int32

Indice in base zero dell'elemento che precede il primo elemento da cercare. Impostare su -1 per avviare la ricerca dall'inizio del controllo.

Restituisce

Int32

Indice in base zero del primo elemento trovato; restituisce -1 se non vengono trovate corrispondenze oppure 0 se il parametro s specifica Empty.

Eccezioni

ArgumentOutOfRangeException

startIndex è minore di -1.

-oppure-

Il parametro startIndex è maggiore dell'ultimo indice contenuto nell'insieme.

Commenti

La ricerca eseguita da questo metodo non fa distinzione tra maiuscole e minuscole. Il s parametro è una sottostringa da confrontare con il testo associato agli elementi nell'elenco casella combinata. La ricerca esegue una corrispondenza parziale a partire dall'inizio del testo, restituendo il primo elemento dell'elenco corrispondente alla sottostringa specificata. È quindi possibile eseguire attività, ad esempio rimuovere l'elemento contenente il testo di ricerca usando il Remove metodo o modificare il testo dell'elemento. Questo metodo viene in genere utilizzato dopo che è stata effettuata una chiamata utilizzando la versione di questo metodo che non specifica un indice iniziale. Dopo aver trovato un elemento iniziale nell'elenco, questo metodo viene in genere usato per trovare altre istanze del testo di ricerca specificando la posizione di indice nel startIndex parametro dell'elemento dopo la prima istanza trovata del testo di ricerca. Se si desidera eseguire una ricerca di una corrispondenza esatta di parola anziché una corrispondenza parziale, usare il FindStringExact metodo .