ComboBox.FindString Metodo

Definizione

Restituisce l'indice del primo elemento nell'oggetto ComboBox che inizia con la stringa specificata.Returns the index of the first item in the ComboBox that starts with the specified string.

Overload

FindString(String)

Restituisce l'indice del primo elemento nell'oggetto ComboBox che inizia con la stringa specificata.Returns the index of the first item in the ComboBox that starts with the specified string.

FindString(String, Int32)

Restituisce l'indice del primo elemento in ComboBox successivo all'indice specificato che contiene la stringa specificata.Returns the index of the first item in the ComboBox beyond the specified index that contains the specified string. Alla ricerca non viene applicata la distinzione tra maiuscole e minuscole.The search is not case sensitive.

FindString(String)

Restituisce l'indice del primo elemento nell'oggetto ComboBox che inizia con la stringa specificata.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

Parametri

s
String

Oggetto String da cercare.The String to search for.

Restituisce

Indice in base zero del primo elemento trovato; restituisce -1 se non vengono trovate corrispondenze.The zero-based index of the first item found; returns -1 if no match is found.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato l'utilizzo del metodo FindString e della proprietà SelectedIndex.The following code example shows the usage of the FindString method and SelectedIndex property. L'esempio fa parte di un esempio di codice completo nella panoramica della 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

Commenti

La ricerca eseguita da questo metodo non fa distinzione tra maiuscole e minuscole.The search performed by this method is not case-sensitive. Il parametro s è una sottostringa da confrontare con il testo associato agli elementi nell'elenco di caselle combinate.The s parameter is a substring to compare against the text associated with the items in the combo box list. La ricerca esegue una corrispondenza parziale a partire dall'inizio del testo e restituisce il primo elemento dell'elenco che corrisponde alla sottostringa specificata.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. È quindi possibile eseguire attività, ad esempio la rimozione dell'elemento che contiene il testo di ricerca usando il metodo Remove o la modifica del testo dell'elemento.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. Una volta trovato il testo specificato, se si desidera cercare altre istanze del testo nella ComboBox, è necessario utilizzare la versione del metodo FindString che fornisce un parametro per specificare un indice iniziale all'interno dell'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. Se si desidera eseguire una ricerca di una parola esatta anziché una corrispondenza parziale, utilizzare il metodo 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)

Restituisce l'indice del primo elemento in ComboBox successivo all'indice specificato che contiene la stringa specificata.Returns the index of the first item in the ComboBox beyond the specified index that contains the specified string. Alla ricerca non viene applicata la distinzione tra maiuscole e minuscole.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

Parametri

s
String

Oggetto String da cercare.The String to search for.

startIndex
Int32

Indice in base zero dell'elemento che precede il primo elemento da cercare.The zero-based index of the item before the first item to be searched. Impostare su -1 per avviare la ricerca dall'inizio del controllo.Set to -1 to search from the beginning of the control.

Restituisce

Indice in base zero del primo elemento trovato; restituisce -1 se non vengono trovate corrispondenze oppure 0 se il parametro s specifica 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.

Eccezioni

startIndex è minore di -1.The startIndex is less than -1.

-oppure--or- Il parametro startIndex è maggiore dell'ultimo indice contenuto nell'insieme.The startIndex is greater than the last index in the collection.

Commenti

La ricerca eseguita da questo metodo non fa distinzione tra maiuscole e minuscole.The search performed by this method is not case-sensitive. Il parametro s è una sottostringa da confrontare con il testo associato agli elementi nell'elenco di caselle combinate.The s parameter is a substring to compare against the text associated with the items in the combo box list. La ricerca esegue una corrispondenza parziale a partire dall'inizio del testo, restituendo il primo elemento dell'elenco che corrisponde alla sottostringa specificata.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. È quindi possibile eseguire attività, ad esempio la rimozione dell'elemento che contiene il testo di ricerca usando il metodo Remove o la modifica del testo dell'elemento.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. Questo metodo viene in genere utilizzato dopo che è stata effettuata una chiamata utilizzando la versione di questo metodo che non specifica un indice iniziale.This method is typically used after a call has been made using the version of this method that does not specify a starting index. Una volta individuato 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 parametro startIndex dell'elemento dopo la prima istanza trovata del testo di ricerca.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. Se si desidera eseguire una ricerca di una parola esatta anziché una corrispondenza parziale, utilizzare il metodo FindStringExact.If you want to perform a search for an exact word match instead of a partial match, use the FindStringExact method.

Si applica a