Hashtable.Item[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; }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
Ключ, значение которого требуется получить или задать.
Значение свойства
Значение, связанное с указанным ключом. Если указанный ключ не найден, попытка получить его возврат nullи попытка задать его создает новый элемент с помощью указанного ключа.
Реализации
Исключения
key равно null.
Свойство задано и Hashtable доступно только для чтения.
–или–
Свойство задано, key не существует в коллекции и Hashtable имеет фиксированный размер.
Комментарии
Это свойство обеспечивает возможность доступа к определенному элементу в коллекции с помощью следующего синтаксиса: myCollection[key]
Можно также использовать Item[] свойство для добавления новых элементов, задав значение ключа, который не существует в Hashtable; например. myCollection["myNonexistentKey"] = myValue Тем не менее, если указанный ключ уже существует в Hashtable, задав Item[] свойство перезаписывает старое значение. Напротив, Add метод не изменяет существующие элементы.
Ключ не может быть null, но значение может быть. Чтобы различать null возвращаемый ключ, так как указанный ключ не найден и null возвращается из-за значения указанного ключа null, используйте Contains метод или ContainsKey метод, чтобы определить, существует ли ключ в списке.
Получение значения этого свойства является операцией O(1) ; задание свойства также является операцией O(1) .
Язык C# использует ключевое this слово для определения индексаторов вместо реализации Item[] свойства. Visual Basic реализует Item[] как свойство по умолчанию, которое предоставляет те же функции индексирования.
