Control.ControlCollection.IndexOfKey(String) Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Recupera o índice da primeira ocorrência do item especificado na coleção.

public:
 virtual int IndexOfKey(System::String ^ key);

public virtual int IndexOfKey (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

Parâmetros

key

String

O nome do controle a ser pesquisado.

Retornos

Int32

O índice baseado em zero da primeira ocorrência do controle com o nome especificado na coleção.

Comentários

Se IndexOfKey for chamado sucessivamente, o último índice retornado será verificado para uma correspondência de chave primeiro e, se não houver correspondência, a pesquisa será iniciada no início da coleção.

A comparação de chave não diferencia maiúsculas de minúsculas. Se o key parâmetro for null ou uma cadeia de caracteres vazia ou um item com a chave especificada não for encontrado, IndexOfKey retornará -1.

A Name propriedade de um Control corresponde à chave de um Control no Control.ControlCollection.