ComboBox.FindString Метод

  • Ссылка

Определение

Пространство имен:
System.Windows.Forms
Сборка:
System.Windows.Forms.dll

Возвращает индекс первого элемента в объекте 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

Параметры

s
String

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

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

Int32

Отсчитываемый от нуля индекс первого найденного элемента; если элемент не найден, возвращается значение -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

Параметры

s
String

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

startIndex
Int32

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

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

Int32

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

Исключения

ArgumentOutOfRangeException

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

-или-

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

Комментарии

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

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