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

Определение

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

System.Collections

Сборки:

mscorlib.dll, System.Collections.NonGeneric.dll

Сборка:

System.Runtime.dll

Сборка:

System.Collections.NonGeneric.dll

Сборка:

System.Runtime.Extensions.dll

Сборка:

mscorlib.dll

Сборка:

netstandard.dll

Возвращает или задает значение, связанное с указанным ключом.

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, set

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

Параметры

key

Object

Задаваемое или получаемое значение ключа.

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

Object

Значение, связанное с указанным ключом. Если указанный ключ не найден, при попытке его получения возвращается значение null, а при попытке задания ключа создается новый элемент с использованием указанного ключа.

Реализации

Item[Object]

Исключения

ArgumentNullException

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

NotSupportedException

Свойство задано, и список 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[], предоставляющее те же возможности индексирования.

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

• Add(Object, Object)