SortedList.Item[Object] Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, связанное с определенным ключом в объекте 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; }public virtual object? this[object key] { get; set; }member this.Item(obj) : obj with get, setDefault Public Overridable Property Item(key As Object) As ObjectПараметры
- key
- Object
Ключ, связанный со значением для получения или задания.
Значение свойства
Значение, связанное с параметром key в объектеSortedList, если key найдено; в противном случае . null
Реализации
Исключения
key равно null.
Свойство задано, и SortedList объект доступен только для чтения.
–или–
Свойство задано, key не существует в коллекции и SortedList имеет фиксированный размер.
Недостаточно доступной памяти для добавления элемента в SortedListэлемент.
Средство сравнения создает исключение.
Комментарии
Свойство можно использовать 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).
