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);

member this.FindString : string -> int

Public Function FindString (s As String) As Integer

参数

s

String

要搜索的 String。

返回

Int32

找到的第一个项的从零开始的索引；如果未找到匹配项，则返回 -1。

示例

下面的代码示例演示方法和 SelectedIndex 属性的FindString用法。 该示例是类概述中完整代码示例的 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);

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，或者，如果 s 参数指定 Empty，则返回 0。

例外

ArgumentOutOfRangeException

startIndex 小于 -1。

- 或 -

startIndex 大于集合中的最后一个索引。

注解

此方法执行的搜索不区分大小写。 参数 s 是一个子字符串，用于与组合框列表中的项关联的文本进行比较。 搜索从文本开头开始执行部分匹配，返回列表中与指定子字符串匹配的第一项。 然后，可以执行任务，例如使用 Remove 方法删除包含搜索文本的项或更改项的文本。 此方法通常在使用未指定起始索引的此方法版本进行调用后使用。 在列表中找到初始项后，此方法通常用于查找搜索文本的更多实例，方法是在搜索文本的第一个找到实例之后指定项参数中的索引位置 startIndex 。 如果要执行搜索完全字词匹配而不是部分匹配，请使用 FindStringExact 方法。