ListView.CheckedListViewItemCollection.IndexOfKey(String) Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Determina o índice de um item com a chave especificada.

public:
 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

Parâmetros

key

String

O nome do item para o qual recuperar o índice.

Retornos

Int32

O índice de base zero para o ListViewItem com o nome especificado, se encontrado; caso contrário, -1.

Exceções

InvalidOperationException

O ListView proprietário está no modo virtual.

Comentários

A Name propriedade de um ListViewItem corresponde à chave de um item em um ListView.CheckedListViewItemCollection.

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, IndexOfKey retornará -1.

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.