Hashtable.Item[Object] Propriedade

Definição

Namespace:

System.Collections

Assembly:

System.Runtime.dll

Origem:

Hashtable.cs

Obtém ou define o valor associado à chave especificada.

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

Parâmetros

key

Object

A chave cujo valor será obtido ou definido.

Valor da propriedade

Object

O valor associado à chave especificada. Se a chave especificada não for encontrada, tentar obtê-la retornará null e tentar de defini-la criará um novo elemento usando a chave especificada.

Implementações

Item[Object]

Exceções

ArgumentNullException

key é null.

NotSupportedException

A propriedade é definida e o Hashtable é somente leitura.

- ou -

A propriedade é definida, key não existe na coleção e o Hashtable tem um tamanho fixo.

Comentários

Esta propriedade fornece a capacidade de acessar um elemento específico na coleção usando a seguinte sintaxe: myCollection[key].

Você também pode usar a Item[] propriedade para adicionar novos elementos definindo o valor de uma chave que não existe no Hashtable; por exemplo, myCollection["myNonexistentKey"] = myValue. No entanto, se a chave especificada já existir no , definir Hashtablea Item[] propriedade substituirá o valor antigo. Por outro lado, o Add método não modifica elementos existentes.

Uma chave não pode ser null, mas um valor pode ser. Para distinguir entre null o que é retornado porque a chave especificada não foi encontrada e null que é retornada porque o valor da chave especificada é null, use o Contains método ou o ContainsKey método para determinar se a chave existe na lista.

Recuperar o valor dessa propriedade é uma O(1) operação; definir a propriedade também é uma O(1) operação.

A linguagem C# usa o this palavra-chave para definir os indexadores em vez de implementar a Item[] propriedade . O Visual Basic implementa Item[] como uma propriedade padrão, que fornece a mesma funcionalidade de indexação.

Confira também

• Add(Object, Object)