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

Определение

Получает или задает значение, связанное с указанным ключом в объекте SortedList.Gets or sets the value associated with a specific key in a SortedList object.

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

Ключ, связанный с задаваемым или возвращаемым значением.The key associated with the value to get or set.

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

Значение, связанное с параметром key в объекте SortedList, если ключ key найден; в противном случае — значение null.The value associated with the key parameter in the SortedList object, if key is found; otherwise, null.

Реализации

Исключения

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

Свойство задано, и объект SortedList доступен только для чтения.The property is set and the SortedList object is read-only.

-или--or- Свойство задано, key не существует в коллекции, а SortedList имеет фиксированный размер.The property is set, key does not exist in the collection, and the SortedList has a fixed size.

Недостаточно свободной памяти для добавления элемента в объект SortedList.There is not enough available memory to add the element to the SortedList.

Средство сравнения выдает исключение.The comparer throws an exception.

Комментарии

Для доступа к определенному элементу в коллекции можно использовать свойство Item[Object], указав следующий синтаксис: myCollection[key].You can use the Item[Object] property to access a specific element in a collection by specifying the following syntax: myCollection[key].

Это свойство также можно использовать для добавления новых элементов путем задания значения ключа, не существующего в SortedList объекте (например, myCollection["myNonexistentKey"] = myValue).You can also use this property to add new elements by setting the value of a key that does not exist in the SortedList object (for example, myCollection["myNonexistentKey"] = myValue). Однако если указанный ключ уже существует в SortedList, установка свойства Item[Object] перезаписывает старое значение.However, if the specified key already exists in the SortedList, setting the Item[Object] property overwrites the old value. В отличие от этого, метод Add не изменяет существующие элементы.In contrast, the Add method does not modify existing elements.

Ключ не может быть null, а значение может быть.A key cannot be null, but a value can be. Для различения возвращаемых null, поскольку указанный ключ не найден и null возвращается, так как значение указанного ключа null, используйте метод Contains или метод ContainsKey, чтобы определить, существует ли ключ в списке.To distinguish between null that is returned because the specified key is not found and null that is returned because the value of the specified key is null, use the Contains method or the ContainsKey method to determine if the key exists in the list.

Элементы SortedList сортируются по ключам в соответствии с конкретной реализацией IComparer, заданной при создании SortedList или в соответствии с реализацией IComparable, предоставляемой самими ключами.The elements of a SortedList are sorted by the keys either according to a specific IComparer implementation specified when the SortedList is created or according to the IComparable implementation provided by the keys themselves.

Язык использует ключевое словоthisдля определения индексаторов вместо реализации свойства Keys. C#The C# language uses the this keyword to define the indexers instead of implementing the Keys property. В языке Visual Basic в качестве свойства по умолчанию реализовано свойство Item[Object], предоставляющее те же возможности индексирования.Visual Basic implements Item[Object] as a default property, which provides the same indexing functionality.

Получение значения этого свойства является O(log n) операцией, где n Count.Retrieving the value of this property is an O(log n) operation, where n is Count. Задание свойства является O(log n)ной операцией, если ключ уже находится в SortedList.Setting the property is an O(log n) operation if the key is already in the SortedList. Если ключ отсутствует в списке, задание свойства является операцией O(n) для несортированных данных или O(log n), если новый элемент добавляется в конец списка.If the key is not in the list, setting the property is an O(n) operation for unsorted data, or O(log n) if the new element is added at the end of the list. Если вставка приводит к изменению размера, операция выполняется O(n).If insertion causes a resize, the operation is O(n).

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

Дополнительно