ListView.CheckedListViewItemCollection.IndexOfKey(String) Метод

Определение

Пространство имен:
System.Windows.Forms
Сборка:
System.Windows.Forms.dll

Определяет индекс для элемента с указанным ключом.Determines the index for an item with the specified key.

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

Параметры

key
String

Имя элемента, для которого нужно извлечь индекс.The name of the item to retrieve the index for.

Возвращаемое значение

Int32

Индекс (отсчет с нуля) для элемента ListViewItem с заданным именем, если такой элемент найден. В противном случае — значение -1.The zero-based index for the ListViewItem with the specified name, if found; otherwise, -1.

Исключения

InvalidOperationException

Владелец ListView находится в виртуальном режиме.The owner ListView is in virtual mode.

Комментарии

NameСвойство объекта ListViewItem соответствует ключу элемента в ListView.CheckedListViewItemCollection .The Name property of a ListViewItem corresponds to the key for an item in a ListView.CheckedListViewItemCollection.

При сравнении ключей регистр символов не учитывается.The key comparison is not case-sensitive. Если key параметр имеет значение null или является пустой строкой, IndexOfKey возвращает значение-1.If the key parameter is null or an empty string, IndexOfKey returns -1.

Если 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.

Применяется к