Control.ControlCollection.IndexOfKey(String) メソッド


指定した項目がこのコレクション内で最初に見つかった位置のインデックスを取得します。Retrieves the index of the first occurrence of the specified item within the collection.

 virtual int IndexOfKey(System::String ^ key);
public virtual int IndexOfKey (string key);
abstract member IndexOfKey : string -> int
override this.IndexOfKey : string -> int
Public Overridable Function IndexOfKey (key As String) As Integer



検索するコントロールの名前。The name of the control to search for.


指定した名前のコントロールがコレクション内で最初に見つかった位置の 0 から始まるインデックス。The zero-based index of the first occurrence of the control with the specified name in the collection.


IndexOfKey が連続して呼び出された場合、最初に返されたインデックスのキーが一致しているかどうかが最初にチェックされます。一致するものがない場合は、コレクションの先頭から検索が開始されます。If IndexOfKey is called successively, the last returned index will be checked for a key match first, and if there is no match, the search starts at the beginning of the collection.

キーの比較では、大文字と小文字は区別されません。The key comparison is not case-sensitive. key パラメーターが null または空の文字列の場合、または指定されたキーを持つ項目が見つからない場合、IndexOfKey は-1 を返します。If the key parameter is null or an empty string, or an item with the specified key is not found, IndexOfKey returns -1.

ControlName プロパティは、Control.ControlCollection内の Control のキーに対応します。The Name property of a Control corresponds to the key for a Control in the Control.ControlCollection.