指定したオブジェクトを検索し、現在の 1 次元インスタンス内でそのオブジェクトが最初に見つかった位置のインデックス番号を返します。
Private Function IndexOf( _
ByVal value As Object _) As Integer Implements IList.IndexOf
[C#]
int IList.IndexOf(
objectvalue);
[C++]
private: int IList::IndexOf(Object* value);
[JScript]
private function IList.IndexOf(
value : Object) : int;
パラメータ
- value
現在の Array 内で検索するオブジェクト。
戻り値
Array 全体で value が見つかった場合は、その値が最初に見つかった位置のインデックス番号。それ以外の場合は、 Array の下限 - 1。
実装
例外
例外の種類 | 条件 |
---|---|
RankException | 現在の Array が多次元です。 |
解説
1 次元の Array 内で、検索は最初の要素から開始して順方向に進み、最後の要素で終了します。
要素は、 Object.Equals メソッドを使用して、指定した値と比較されます。要素の型が非組み込み型 (ユーザー定義型) の場合は、この型の Equals 実装が使用されます。
ほとんどの配列の下限は 0 であるため、 value が見つからない場合、このメソッドは通常 -1 を返します。配列の下限が Int32.MinValue に等しく、 value が見つからないまれな場合、このメソッドは Int32.MaxValue を返します。これは System.Int32.MinValue - 1
です。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, Common Language Infrastructure (CLI) Standard