ComboBox.FindString Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает индекс первого элемента в объекте ComboBox, начинающегося с заданной строки.
Перегрузки
FindString(String) |
Возвращает индекс первого элемента в объекте ComboBox, начинающегося с заданной строки. |
FindString(String, Int32) |
Возвращает индекс первого элемента в объекте ComboBox после указанного индекса, содержащего заданную строку. Поиск не учитывает регистр символов. |
FindString(String)
Возвращает индекс первого элемента в объекте ComboBox, начинающегося с заданной строки.
public:
int FindString(System::String ^ s);
public int FindString (string s);
public int FindString (string? s);
member this.FindString : string -> int
Public Function FindString (s As String) As Integer
Параметры
Возвращаемое значение
Отсчитываемый от нуля индекс первого найденного элемента; если элемент не найден, возвращается значение -1.
Примеры
В следующем примере кода показано использование FindString метода и SelectedIndex свойства . Пример является частью полного примера кода в обзоре ComboBox класса.
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
Комментарии
Поиск, выполняемый этим методом, не учитывает регистр. Параметр s
является подстрокой для сравнения с текстом, связанным с элементами в списке полей со списком. Поиск выполняет частичное совпадение, начиная с начала текста, и возвращает первый элемент в списке, соответствующий указанной подстроке. Затем можно выполнять такие задачи, как удаление элемента, содержащего текст поиска, с помощью Remove метода или изменение текста элемента. После обнаружения указанного текста, если вы хотите найти другие экземпляры текста в ComboBox, необходимо использовать версию FindString метода , которая предоставляет параметр для указания начального индекса в ComboBox. Если вы хотите выполнить поиск точного совпадения слов, а не частичного совпадения FindStringExact , используйте метод .
Применяется к
FindString(String, Int32)
Возвращает индекс первого элемента в объекте ComboBox после указанного индекса, содержащего заданную строку. Поиск не учитывает регистр символов.
public:
int FindString(System::String ^ s, int startIndex);
public int FindString (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
Параметры
- startIndex
- Int32
Индекс элемента перед первым искомым элементом (индексация ведется от нуля). Задано значение -1 для выполнения поиска с начала элемента управления.
Возвращаемое значение
Индекс первого найденного элемента (индексация ведется от нуля); если соответствующий элемент не найден, возвращается значение -1; или значение 0, если параметр s
задает Empty.
Исключения
Значение параметра startIndex
меньше –1.
-или-
Параметр startIndex
больше последнего индекса в коллекции.
Комментарии
Поиск, выполняемый этим методом, не учитывает регистр. Параметр s
является подстрокой для сравнения с текстом, связанным с элементами в списке полей со списком. Поиск выполняет частичное совпадение, начиная с начала текста, возвращая первый элемент в списке, соответствующий указанной подстроке. Затем можно выполнять такие задачи, как удаление элемента, содержащего текст поиска, с помощью Remove метода или изменение текста элемента. Этот метод обычно используется после вызова с использованием версии этого метода, которая не указывает начальный индекс. После обнаружения исходного элемента в списке этот метод обычно используется для поиска дополнительных экземпляров текста поиска путем указания позиции индекса в startIndex
параметре элемента после первого найденного экземпляра поискового текста. Если вы хотите выполнить поиск точного совпадения слов, а не частичного совпадения FindStringExact , используйте метод .