SortedList.Item[Object] Свойство

Определение

Пространство имен:

System.Collections

Сборка:

System.Collections.NonGeneric.dll

Исходный код:

SortedList.cs

Получает или задает значение, связанное с указанным ключом в объекте SortedList.

public:
 virtual property System::Object ^ default[System::Object ^] { System::Object ^ get(System::Object ^ key); void set(System::Object ^ key, System::Object ^ value); };

public virtual object? this[object key] { get; set; }

member this.Item(obj) : obj with get, set

Default Public Overridable Property Item(key As Object) As Object

Параметры

key

Object

Ключ, связанный с задаваемым или возвращаемым значением.

Значение свойства

Object

Значение, связанное с параметром key в объекте SortedList, если ключ key найден; в противном случае — значение null.

Реализации

Item[Object]

Исключения

ArgumentNullException

key имеет значение null.

NotSupportedException

Свойство задано, и объект SortedList доступен только для чтения.

-или-

Свойство задано, key не существует в коллекции, а SortedList имеет фиксированный размер.

OutOfMemoryException

Недостаточно свободной памяти для добавления элемента в объект SortedList.

InvalidOperationException

Средство сравнения выдает исключение.

Комментарии

Свойство можно использовать Item[] для доступа к определенному элементу в коллекции, указав следующий синтаксис: myCollection[key].

Это свойство также можно использовать для добавления новых элементов, задав значение ключа, не существующего в объекте SortedList (например, myCollection["myNonexistentKey"] = myValue). Однако, если указанный ключ уже существует в SortedList, установка Item[] свойства перезаписывает старое значение. В отличие от этого, Add метод не изменяет существующие элементы.

Ключ не может быть null, но значение может быть . Чтобы различать null , что возвращается, так как указанный ключ не найден, и null возвращается из-за того, что значение указанного ключа равно null, используйте Contains метод или ContainsKey метод , чтобы определить, существует ли ключ в списке.

Элементы SortedList объекта сортируются по ключам либо в соответствии с определенной IComparer реализацией, указанной SortedList при создании , либо в соответствии с IComparable реализацией, предоставляемой самими ключами.

В языке C# при определении индексаторов вместо реализации свойства this используется ключевое слово Keys. В языке Visual Basic в качестве свойства по умолчанию реализовано свойство Item[], предоставляющее те же возможности индексирования.

Получение значения этого свойства является операцией O(log n) , где n — Count. Задание свойства является операцией O(log n) , если ключ уже находится в SortedList. Если ключа нет в списке, задание свойства является операцией O(n) для несортированных данных или O(log n) если новый элемент добавляется в конец списка. Если вставка вызывает изменение размера, операция имеет значение O(n).

См. также раздел

• Add(Object, Object)
• Contains(Object)
• ContainsKey(Object)
• Выполнение строковых операций без учета языка и региональных параметров в коллекциях