Прочитать на английском

Поделиться через


ComboBox.FindString Метод

Определение

Возвращает индекс первого элемента в объекте ComboBox, начинающегося с заданной строки.

Перегрузки

FindString(String)

Возвращает индекс первого элемента в объекте ComboBox, начинающегося с заданной строки.

FindString(String, Int32)

Возвращает индекс первого элемента в объекте ComboBox после указанного индекса, содержащего заданную строку. Поиск не учитывает регистр символов.

FindString(String)

Возвращает индекс первого элемента в объекте ComboBox, начинающегося с заданной строки.

C#
public int FindString (string s);
C#
public int FindString (string? s);

Параметры

s
String

Объект String, который требуется найти.

Возвращаемое значение

Отсчитываемый от нуля индекс первого найденного элемента; если элемент не найден, возвращается значение -1.

Примеры

В следующем примере кода показано использование FindString метода и SelectedIndex свойства . Пример является частью полного примера кода в обзоре ComboBox класса.

C#
private void findButton_Click(object sender, System.EventArgs e) {
    int index = comboBox1.FindString(textBox2.Text);
    comboBox1.SelectedIndex = index;
}

Комментарии

Поиск, выполняемый этим методом, не учитывает регистр. Параметр s является подстрокой для сравнения с текстом, связанным с элементами в списке полей со списком. Поиск выполняет частичное совпадение, начиная с начала текста, и возвращает первый элемент в списке, соответствующий указанной подстроке. Затем можно выполнять такие задачи, как удаление элемента, содержащего текст поиска, с помощью Remove метода или изменение текста элемента. После обнаружения указанного текста, если вы хотите найти другие экземпляры текста в ComboBox, необходимо использовать версию FindString метода , которая предоставляет параметр для указания начального индекса в ComboBox. Если вы хотите выполнить поиск точного совпадения слов, а не частичного совпадения FindStringExact , используйте метод .

Применяется к

.NET Framework 4.8.1 и другие версии
Продукт Версии
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

FindString(String, Int32)

Возвращает индекс первого элемента в объекте ComboBox после указанного индекса, содержащего заданную строку. Поиск не учитывает регистр символов.

C#
public int FindString (string s, int startIndex);
C#
public int FindString (string? s, int startIndex);

Параметры

s
String

Объект String, который требуется найти.

startIndex
Int32

Индекс элемента перед первым искомым элементом (индексация ведется от нуля). Задано значение -1 для выполнения поиска с начала элемента управления.

Возвращаемое значение

Индекс первого найденного элемента (индексация ведется от нуля); если соответствующий элемент не найден, возвращается значение -1; или значение 0, если параметр s задает Empty.

Исключения

Значение параметра startIndex меньше –1.

-или-

Параметр startIndex больше последнего индекса в коллекции.

Комментарии

Поиск, выполняемый этим методом, не учитывает регистр. Параметр s является подстрокой для сравнения с текстом, связанным с элементами в списке полей со списком. Поиск выполняет частичное совпадение, начиная с начала текста, возвращая первый элемент в списке, соответствующий указанной подстроке. Затем можно выполнять такие задачи, как удаление элемента, содержащего текст поиска, с помощью Remove метода или изменение текста элемента. Этот метод обычно используется после вызова с использованием версии этого метода, которая не указывает начальный индекс. После обнаружения исходного элемента в списке этот метод обычно используется для поиска дополнительных экземпляров текста поиска путем указания позиции индекса в startIndex параметре элемента после первого найденного экземпляра поискового текста. Если вы хотите выполнить поиск точного совпадения слов, а не частичного совпадения FindStringExact , используйте метод .

Применяется к

.NET Framework 4.8.1 и другие версии
Продукт Версии
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9