FindStringExact(String,Int32,String) メソッド

指定したインデックスの後に出現する、指定したテキスト書式に基づく指定した文字列と一致する最初の項目を検索します。

構文

Visual Basic (宣言)
C#

Public Overloads Function FindStringExact( _
   ByVal s As String, _
   ByVal startIndex As Integer, _
   ByVal textFormat As String _
) As Integer

public int FindStringExact( 
   string s,
   int startIndex,
   string textFormat
)

パラメータ

s: 検索キーとなる文字列を表す String 値。
startIndex: 検索の開始位置の直前の位置を示す 0 から始まるインデックス。
textFormat: テキスト書式を参照するSystem.String。

戻り値の型

最初に見つかった項目の0から始まるインデックス。一致する項目が見つからない場合は-1を返します。

例外

例外	解説
System.ArgumentOutOfRangeException	startIndex が範囲外です。
System.ArgumentException	textFormat が有効なテキスト書式ではありません。
System.ArgumentOutOfRangeException	startIndex が -1 未満です。もしくは startIndex が（アイテム数 -1）を超えています。

解説

System.ArgumentOutOfRangeException

startIndex が範囲外です。

System.ArgumentException

textFormat が有効なテキスト書式ではありません。

System.ArgumentOutOfRangeException

startIndex が -1 未満です。

もしくは

startIndex が（アイテム数 -1）を超えています。

解説

このメソッドで実行される検索では、大文字と小文字は区別されます。sパラメーターは、コンボボックスリストの各項目に関連付けられたテキストに対して比較する文字列です。テキストの先頭から一致が検索されて、指定した文字列に一致するリストの最初の項目が返されます。その後で、ListItemCollection.Remove メソッドを使用して検索文字列を含む項目を削除したり、項目のテキストを変更したりできます。このメソッドは通常、同じメソッドの開始インデックスを指定しないバージョンを呼び出した後に使用します。通常は、検索文字列に一致する最初の項目が見つかった後で、その項目の1つ後の項目のインデックス位置をstartIndexパラメーターに指定してこのメソッドを呼び出し、同じ文字列の別のインスタンスをさらに検索します。厳密な単語の一致ではなく単語の部分一致を検索する場合は、FindString(String,Int32) メソッドを使用します。

このメソッドで実行される検索は循環しません。しかし、startIndexパラメーターから検索が始まり、コレクションの最後に到達した場合には 0 から検索が再実行されます。startIndexパラメーター自体がコレクション内の最後のインデックスと同じ場合は、例外がスローされます。

参照

GcComboBoxCell クラス
 GcComboBoxCell メンバ
 オーバーロード一覧