Compartilhar via


Control.ControlCollection.IndexOfKey(String) Método

Definição

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.

Aplica-se a