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

最初に見つかった項目の 0 から始まるインデックス番号。一致する項目が見つからない場合は、-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でComboBox開始インデックスを指定するためのパラメーターを提供する メソッドのFindStringバージョンを使用する必要があります。 部分一致ではなく完全一致語の検索を実行する場合は、 メソッドを使用します 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

最初の検索対象項目の前にある項目の 0 から始まるインデックス番号。 コントロールの先頭から検索する場合は -1 を設定します。

戻り値

Int32

最初に見つかった項目のインデックス (0 から始まる)。一致する項目が見つからない場合は -1。s パラメーターに Empty が指定されている場合は 0。

例外

ArgumentOutOfRangeException

startIndex が -1 より小さい。

- または -

startIndex がコレクション内の最後のインデックスを超える値です。

注釈

このメソッドによって実行される検索では、大文字と小文字は区別されません。 パラメーターは s 、コンボ ボックス リスト内の項目に関連付けられているテキストと比較する部分文字列です。 検索では、テキストの先頭から部分一致が実行され、指定した部分文字列に一致するリスト内の最初の項目が返されます。 その後、 メソッドを使用して Remove 検索テキストを含むアイテムを削除したり、アイテムのテキストを変更したりするなどのタスクを実行できます。 このメソッドは通常、開始インデックスを指定しないこのメソッドのバージョンを使用して呼び出しが行われた後に使用されます。 リストで最初の項目が見つかったら、このメソッドは通常、検索テキストの最初に見つかったインスタンスの後の項目のパラメーターに startIndex インデックス位置を指定することで、検索テキストのインスタンスをさらに検索するために使用されます。 部分一致ではなく完全一致語の検索を実行する場合は、 メソッドを使用します FindStringExact 。